This is the source for the official SUSE CaaS Platform documentation
Released versions of the documentation will be published at https://documentation.suse.com/ once available.
Important
|
Allow maintainer updates for pull requests
When creating a Pull Request please allow maintainers to push commits into your fork.
See: https://help.github.com/en/articles/allowing-changes-to-a-pull-request-branch-created-from-a-fork
|
If you would like to contribute, please fork this repository and send pull requests.
Fork the master
branch for requesting changes to the SUSE CaaS Platform 4.0 and higher documentation.
For help on style and structure, refer to the Documentation Styleguide
Changes to already released versions of the documentation must be merged to a maintenance/CaaSX
branch from the maintainer.
-
DC-caasp-*
: Configuration files for the exported guides. -
adoc/
: Contains all the pages that make up the content. -
adoc/book_*
: Meta files collating pages into a guide document. -
adoc/attributes.adoc
- Contains all version numbers of the product and it’s components. Also contains therelease_type
flag that determines if the branch contains anpublic
or (SUSE)internal
release. -
adoc/entities.adoc
- Contains text substitutions for often used component names and strings. -
adoc/common_*
: Include files with common information like legal disclaimers and licenses. -
adoc/admin-*
: Pages belonging to the Admin guide. -
adoc/deployment-*
: Pages belonging to the Deployment guide. -
adoc/architecture-*
: Pages belonging to the Architecture guide. -
adoc/quick-*
: Pages belonging to the Quickstart guide.
To contribute to the documentation you will use AsciiDoc syntax.
-
You can learn about AsciiDoc syntax at https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/
-
A much more detailed manual can be found here
-
-
For simple preview use the browser extensions for
-
SUSE documents are generally built with DAPS (package
daps
) and the SUSE XSL Stylesheets (packagesuse-xsl-stylesheets
). It’s available as a SUSE rpm package from the the SUSE repository Documentation:Tools or directly from Github. -
If you are running a (recent) version of openSUSE, you can install our documentation toolchain with the following command:
sudo /sbin/OneClickInstallUI https://gitlab.nue.suse.com/susedoc/doc-ymp/raw/master/Documentation.ymp
-
If you don’t want to download the entire documentation toolchain, you can also build documentation using DAPS inside a Docker container with daps2docker:
-
Clone the daps2docker repository.
-
Change directory to the folder which contains your documentation source files (
doc-caasp
). -
Execute the
daps2docker.sh
file, for example by running../daps2docker/daps2docker.sh .
. -
Follow the commandline instructions for further building options.
-
-
Basic daps usage:
-
$ daps -d DC-<YOUR_BOOK> validate
: Make sure what you have written is well-formed XML and valid DocBook 5 -
$ daps -d DC-<YOUR_BOOK> pdf
: Build a PDF document -
$ daps -d DC-<YOUR_BOOK> html
: Build multi-page HTML document -
Learn more at https://opensuse.github.io/daps
-