Corteza technical and user documentation

• link:src/overview/index.adoc[Overview]
• link:src/releases/index.adoc[Releases]
• link:src/user/index.adoc[User manual]
• link:src/extdev/index.adoc[Extending and customization]
• link:src/maint/index.adoc[Maintainer's manual]
• link:src/coredev/index.adoc[Core developer's documentation]
• link:src/manage/index.adoc[System management]

== Authoring

Documentation is written in https://asciidoctor.org/docs/what-is-asciidoc/[AsciiDoc] format and processed with https://asciidoctor.org/[AsciiDoctor]

Before you start, be sure you are familiar with https://asciidoctor.org/docs/asciidoc-writers-guide/[syntax and formatting] rules of AsciiDoc format.

.https://asciidoctor.org/docs/asciidoc-recommended-practices/[Rules to follow]:

• One sentence per line.
• Atx-style section titles

and other recommended practices from the linked page

=== Structure

Documentation is divided into 6 major chapters:

• overview
• releases
• user manual
• extending
• maintainer
• core developer
• system management

=== Building manually

Use provided Makefile with task for building individual major chapters as HTML.

.Build all chapters as HTML (and put them under dist/html/ folder) [source]

make html

.Build user manual chapter as HTML (and put it under dist/html/user folder) [source]

make html.user