Here is the v1.2.2-RC1 review version. https://opengridforum.github.io/DFDL/spec/ as html and PDF.
Note that we have 43 open issues on it as of right now that number excludes issues explicitly deferred to a future DFDL v2.0 https://github.com/OpenGridForum/DFDL/issues?q=is%3Aissue+state%3Aopen+-label%3A%22DFDL+2.0%22 One of those issues has already found a minor Daffodil bug: https://issues.apache.org/jira/browse/DAFFODIL-3111 On Wed, Nov 11, 2026 at 7:43 AM Mike Beckerle <[email protected]> wrote: > 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 >> >
