The source files for the documentation is placing in content directory.
The PipeCD documentation website is built with hugo and published at https://pipecd.dev
PipeCD official site contains multiple versions of documentation, all placed under the /docs/content/en directory, which are:
/docs-dev: experimental version docs, contains docs for not yet released features or changes./docs-v0.x.x: contains docs for specified version family (a version family is all versions which in the same major release).
Here are the flow of docs contribution regard some known scenarios:
- Update docs that are related to a specified version (which is not the latest released version):
In such case, update the docs under
/docs-v0.x.xis enough. - Update docs for not yet released features or changes:
In such case, update the docs under
/docs-devis enough. - Update docs that are related to the latest released docs version:
Change the docs' content that fixes the issue under
/docs-devand/docs-v0.x.x, they share the same file structure so you should find the right files in both directories.
If you find any issues related to the docs, we're happy to accept your help.
Run make run/site at the root directory of the repository and then access http://localhost:1313