Generate html and pdf documentation:

mvn generate-resources

Tip: You can build the documentation without installing Maven locally by using Docker:

docker run --rm -v "$PWD":/docs -w /docs maven:3.8.8 mvn generate-resources

Documentation is generated under target/generated-docs folder

Serve documentation on local http server:

mvn jetty:run

Tip: You can also serve the documentation using Docker without installing Maven:

docker run --rm -it -p 8080:8080 -v "$PWD":/docs -w /docs maven:3.8.8 mvn jetty:run

Then open your browser to http://localhost:8080

then open the browser to http://localhost:8080

To maintain consistency across the documentation, please follow these naming conventions:

All documentation files should use lowercase naming with hyphens between words:

• ✅ lowercase-with-hyphens.adoc
• ❌ CamelCase.adoc
• ❌ UPPERCASE.adoc
• ❌ snake_case.adoc

Document anchors should also use lowercase with hyphens:

[[anchor-id-example]]
== Section Title

Cross-references should use the lowercase anchor IDs:

See the <<anchor-id-example,related section>> for more information.

The documentation includes automated validation to ensure consistency and correctness.

Run the documentation validator locally:

python docs-validator.py

This validator checks:

1. File naming conventions (lowercase with hyphens)
2. Anchor naming conventions (lowercase with hyphens)
3. Cross-reference validity (all references point to existing anchors)
4. Orphaned pages (pages not referenced by other pages)

The documentation validator runs automatically on GitHub when changes are pushed or pull requests are created. This ensures that documentation standards are maintained consistently.