build: upgrade to Java 21 and reorganize documentation master
authorSvjatoslav Agejenko <svjatoslav@svjatoslav.eu>
Sun, 27 Sep 2026 15:04:10 +0000 (18:04 +0300)
committerSvjatoslav Agejenko <svjatoslav@svjatoslav.eu>
Sun, 27 Sep 2026 15:04:10 +0000 (18:04 +0300)
commit735d7dbfeb2f1de870f3caafd045661d2f7b986a
tree7bc293873c396702501adbbef63afc1b6667466d
parent434783ca9bf29184359cad91257569c201d7ad87
build: upgrade to Java 21 and reorganize documentation

Bump java.version, maven.compiler source/target and the compiler
plugin configuration from 1.8 to 21.

Rename doc/ to Documentation/ following the house convention, updating
.gitignore, Tools/Update web site and AGENTS.md accordingly.

Reorganize the Documentation pages into prerequisite reading order:
the overview page leads with Introduction and Usage before
Installation and Source code; the CLI page explains class selection
concepts before the argument reference; the Java API page covers
Maven embedding before the examples.

Fix stale content: retarget sixth-3d links to the renamed Aukio 3D
project site, update CLI examples to aukio-3d artifacts and packages,
and mark the embedded-project example as outdated.

Align with the shared doc-set conventions: add the canonical
style.css, link it from every page via HTML_HEAD, give every heading
a CUSTOM_ID, use anchor-form back-links on sub-pages, and record the
conventions in AGENTS.md.
23 files changed:
.gitignore
AGENTS.md
Documentation/JavaInspect full project.png [new file with mode: 0644]
Documentation/JavaInspect.dot [new file with mode: 0644]
Documentation/JavaInspect.png [new file with mode: 0644]
Documentation/Usage from CLI/index.org [new file with mode: 0644]
Documentation/Usage via Java API/index.org [new file with mode: 0644]
Documentation/example-thumbnail.png [new file with mode: 0644]
Documentation/example.png [new file with mode: 0644]
Documentation/index.org [new file with mode: 0644]
Documentation/legend.png [new file with mode: 0644]
Documentation/style.css [new file with mode: 0644]
Tools/Update web site
doc/JavaInspect full project.png [deleted file]
doc/JavaInspect.dot [deleted file]
doc/JavaInspect.png [deleted file]
doc/Usage from CLI/index.org [deleted file]
doc/Usage via Java API/index.org [deleted file]
doc/example-thumbnail.png [deleted file]
doc/example.png [deleted file]
doc/index.org [deleted file]
doc/legend.png [deleted file]
pom.xml