ownCloud Documentation (v2)
Table of Contents
Refer to the Antora Site Structure for Docs for more information.
Refer to the Documentation Guidelines for more information about backgrounds and processes.
To get started contributing to the documentation, please refer to the Getting Started Guide.
With regard to language and style issues, consult the Style Guide.
IMPORTANT
We recently have upgraded to node 18.19.0
. In case you used a lower node version for your local doc repos, you must upgrade them all. See the link below for details.
IMPORTANT
We recently have upgraded to Antora 3.1.7
. In case you used a lower Antora version for your local doc repos, you must upgrade them all by running yarn install
in each doc repo.
To generate and view the documentation locally or planning major changes, 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.
Refer to Best Practices and Tips for writing in AsciiDoc for more information.
To check for broken links manually, see install and use a broken-link-checker.
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 under the following conditions:
Please refer to Create a New Version Branch for Docs for more information.
At the moment, creating a pdf from a component via Antora is broken and will be fixed past updating to Antora 3. In the meanwhile a workaround is provided, see the HTML to PDF description.