This repository contains the sources for the Cloudflow web site and the Cloudflow documentation
This repository is structured as follows:
- The root directory contains the
makefile
for the documentation generation process. - The source files for the home page and other
root
pages in the website are located underhomepage-source/
. - The structured documentation is located under
docs-source/
.
Additionally, the style used to generate the published website is available at: https://github.com/lightbend/antora-ui-lightbend-cloud-theme
Contributions to the documentation are welcome and encouraged. If you are unfamiliar with the project or with asciidoc, please read the contribution guidelines below.
Detailed information about working with the documentation is provided in the docs-source folder.
The Cloudflow documentation is built using Antora, from asciidoc sources.
The building process is managed by make
using the makefile script.
To build the documentation, use make
with the following commands:
make all
(default)::
Generates the complete documentation bundle, including the Cloudflow docs, the website pages, and the java and scala docs.
The result is available at docs-source/build/site/
make html
::
Generates the html documentation and homepage. The result is available at techhub/build/site/
.
make html-author-mode
::
Generates the documentation, in 'author' mode, to display review comments and TODOs. The result is available at techhub/build/site/cloudflow/<version>
.
-
make check-links
Checks that the external links point to a reachable URL.
-
make list-todos
List all the TODOs, review comments, unresolve references, etc. from the documentation.
TBW
TBW
TODO: copy the asciidoc help from the old
user-guide
README.