I would like to get the latest DFDL workgroup version HTML and pdf to be hosted at GitHub pages so others can just use it and hopefully find and submit bugs. These would be versions we choose to tag, not every single commit.
I.e., 3 versions total: - latest tagged workgroup review version (HTML and pdf), hosted on github - ogf version (pdf only), hosted by ogf - iso version ($$$ and pdf only), avail from iso If there are no errata in the works then all 3 would converge on identical content, though iso has different front matter. Mike Beckerle Apache Daffodil | daffodil.apache.org OGF DFDL Workgroup | www.ogf.org/ogf/doku.php/standards/dfdl/dfdl On Tue, Nov 10, 2026, 11:23 AM Aaron Bauman <[email protected]> wrote: > 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 >
