{"id":22914067,"url":"https://github.com/suse/doc-ses","last_synced_at":"2025-09-11T23:09:11.112Z","repository":{"id":27719244,"uuid":"31206497","full_name":"SUSE/doc-ses","owner":"SUSE","description":"Official SUSE Enterprise Storage documentation","archived":false,"fork":false,"pushed_at":"2024-12-02T13:37:51.000Z","size":134351,"stargazers_count":14,"open_issues_count":3,"forks_count":50,"subscribers_count":26,"default_branch":"main","last_synced_at":"2025-05-06T20:51:42.032Z","etag":null,"topics":["documentation","enterprise","storage","suse"],"latest_commit_sha":null,"homepage":"https://documentation.suse.com/ses/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SUSE.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2015-02-23T12:06:41.000Z","updated_at":"2024-12-02T13:37:55.000Z","dependencies_parsed_at":"2023-02-14T19:00:51.575Z","dependency_job_id":"8fbb7fef-3289-4c8b-8575-80ceea489292","html_url":"https://github.com/SUSE/doc-ses","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SUSE%2Fdoc-ses","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SUSE%2Fdoc-ses/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SUSE%2Fdoc-ses/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SUSE%2Fdoc-ses/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SUSE","download_url":"https://codeload.github.com/SUSE/doc-ses/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253181406,"owners_count":21866990,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["documentation","enterprise","storage","suse"],"created_at":"2024-12-14T05:13:14.617Z","updated_at":"2025-05-09T02:50:50.205Z","avatar_url":"https://github.com/SUSE.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"= SUSE Enterprise Storage Documentation\n\nDocumentation for the SUSE Enterprise Storage Product\n\nReleased versions of the documentation are published at\nhttps://documentation.suse.com/#ses.\n\n\n== Branches\n\n.Overview of important branches\n[options=\"header\"]\n|================================================\n| Name              | Purpose\n| `main`            | development for SES 7\n| `maintenance/ses6`| stable for SES 6\n| `maintenance/ses5`| stable for SES 5.5\n|================================================\n\n***On Feb 20, 2021, we switched to a new default branch.***\n***The default branch is now called `main`.***\n\n* *Use the main branch* as the basis of your commits/of new feature branches.\n\n\n=== How to update your local repository\n\nIf you *created* a local clone or GitHub fork of this repo *before Feb 20, 2021, do the following*:\n\n[code]\n====\ngit branch -m master main\ngit fetch origin\ngit branch -u origin/main main\ngit pull -r\n====\n\n== Contributing\n\nThank you for contributing to this repo. When creating a pull request, please follow the guidelines below:\n\n. If you want to contribute to the most recent release, create your pull request against the `main` branch. The `main` branch is protected.\n\n. If you want to contribute to a previous release, please create your pull request against the respective `maintenance/*` branch. These branches are also protected.\n\n. Make sure all validation (Travis CI) checks are passed.\n\n. For your pull request to be reviewed, please tag the relevant subject matter expert(s) from the development team (if applicable) and members of the documentation team.\n\n. Implement the required changes. If you have any questions, ping a documentation team member in #susedoc on RocketChat.\n\n. For help on style and structure, refer to the https://documentation.suse.com/style/current[Documentation Style Guide].\n\n. Modified DocBook files are re-formatted automatically on each pull request. If you still want to reformat the documentation manually, use `daps xmlformat`.\n\n== Editing DocBook\n\nTo contribute to the documentation, you need to write DocBook.\n\n* You can learn about DocBook syntax at http://docbook.org/tdg5/en/html .\n* SUSE documents are generally built with DAPS (package `daps`) and the\n  SUSE XSL Stylesheets (package `suse-xsl-stylesheets`).\n\n*  Install the documentation environment with the following command:\n+\n[source]\n----\nsudo OneClickInstallUI https://susedoc.github.io/ymp/Documentation.ymp\n----\n\n* Basic DAPS usage:\n** `$ daps -d DC-\u003cYOUR_BOOK\u003e validate`: Make sure what you have written is\n    well-formed XML and valid DocBook 5\n** `$ daps -d DC-\u003cYOUR_BOOK\u003e pdf`: Build a PDF document\n** `$ daps -d DC-\u003cYOUR_BOOK\u003e html`: Build multi-page HTML document\n** `$ daps -d DC-\u003cYOUR_BOOK\u003e optipng`: Always optimize new PNG images\n** Learn more at https://opensuse.github.io/daps\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuse%2Fdoc-ses","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuse%2Fdoc-ses","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuse%2Fdoc-ses/lists"}