ID

R806

Status

Backlog

Bucket

dx

Priority

7

Theme

tooling

Created

2026-08-22

Updated

2026-08-22

Derive the docs staging css/docinfo fan-out from the staged tree

docs/pom.xml carries a hand-maintained per-directory roster for the staged site’s assets: one <copy> of css/ and the two docinfo-*.html theme files per staged directory, every entry failonerror="false". The roster is a copy of a fact the staged tree already states (which directories contain rendered pages), and a missed entry fails nothing: the AsciiDoctor error handler does not see it, the ant-level signal is suppressed, and the first report is a human noticing a published page with no stylesheet and no site nav. Every new docs directory (the principles section, per the principles-section-under-architecture item, is the occasion that exposed this) must remember to append two entries by hand.

The fix is to derive the fan-out: a build step that walks the staged tree and copies css/ and the docinfo files into every staged directory containing a .adoc, deleting the roster. SchemaIdentifierDriftCheck reading the booted store instead of the DDL is the in-repo precedent for reading the tree rather than listing it; the roadmap-tool staging step already runs Java over the same tree, so it is a natural host.