- The platform and tools used to build the documentation is Antora.
- The file format that the documentation is written in is AsciiDoc.
- The UI & UX of the documentation can be found at docs-ui
To get started contributing to the documentation, please refer to the Getting Started Guide.
To generate the documentation, whether in HTML or PDF format, please refer to the Building the Documentation guide.
If you want to suggest an improvement to the ownCloud documentation theme, such as the layout, the header or the footer text, or if you find a bug, all the information that you need is in the docs-ui
repository. Changes made in docs-ui
are valid for the whole documentation.
Please read how to test un-merged docs-ui changes with content from the ownCloud documentation.
Please refer to Best Practices and Tips for writing in AsciiDoc for more information.
Please always do your changes in master
and backport them to the relevant branches.
The ONLY reason for doing a PR in a branch directly is, to fix an issue which is
only present in that particular branch! When creating a PR and it is necessary to backport,
document in the PR to which branches a backport is needed.
When backporting, consider using the backport script which eases life a lot and speeds up the process. It is also very benificial when using the extended code provided, because a clear naming structure of the backport PR is generated automatically.
Changes made will get published to the web with following conditions:
- A nightly running drone job pulls the documentation from the Client, IOS and Android repo. This pull will further be used for any build triggered mentioned below. This means, that changes made in one of these repos, a merge to master or one of the used branches in docs the next day is needed to get them published.
- A merge to one of the defined version branches triggers as last step a master branch build.
- A merge to master triggers a site build which then pushes all versions defined in site.yml
Please refer to Create a New Version Branch for Docs for more information.