On Mon, Nov 09, 2026 at 12:14:56PM -0500, Steve Lawrence via dev wrote: > This looks great! > > We currently have an older html version on the Daffodil site here: > > https://daffodil.apache.org/docs/dfdl/ > > Is the plan for these new versions to be hosted on the OGF DFDL site or > should we plan to update the Daffodil site to include them once finalized? > > Also, do you know if the new adoc files could be integrated into something > like Antora (https://docs.antora.org). One big page is useful for searching > for keywords, but a number of smaller pages might have some advantages. > > - Steve >
Hi Steve, Thanks! On hosting, that's for the WG to decide. Technically, the build produces a single HTML file, so it can replace the current Daffodil page at the same URL. Antora isn't a good fit for this source: - It's Metanorma, not plain AsciiDoc. Antora renders with Asciidoctor.js. The OGF/ISO front matter (:doctype: international-standard and the related metadata) and the fixed table numbers (number=) are Metanorma-only, so they won't render. - The [bits] diagrams wouldn't build. They come from a Ruby extension, and Antora only runs JavaScript extensions. - Numbering restarts on every page. In AsciiDoc, section numbering applies to one document, and every Antora page is its own document. Antora has no built-in way to number across pages, so splitting the spec would break references like "13.2.1" and "Table 34". So moving to Antora would mean reworking the source or building custom tooling to replace what Metanorma already does. Aaron
signature.asc
Description: PGP signature
