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
On 2026-11-08 05:42 PM, Mike Beckerle via dev wrote:
FYI there should soon be a new version of the DFDL spec. This has
additional errata fixes in it, and a ...
*BIG NEW FEATURE*: a clickable property index for all properties.
Plus hyperlinks within the document to sections all work properly now (in
both PDF and HTML versions) and there are no broken links.
Sneak peak (not quite done yet, but hey....) at:
https://github.com/user-attachments/files/34556619/dfdl.pdf?raw=true
All this is enabled by conversion of the spec into ASCIIDOC, and a docker
and makefile driven tool chain that creates both PDF and HTML versions of
the spec.
(and.... even creates an ISO-formatted version of it for submission as an
update to the ISO/IEC 23415:2024 standard document.)
Yes, every property definition now has a URL, which can definitely be
useful, but along the way the tool chain creates an XML version of the spec
as an intermediate form. This XML may be useful for hooking into the VSCode
GUI for DFDL for example, in some way richer than just using the property
URLs.
Many thanks are due to Aaron Bauman for making this happen.
Mike Beckerle
Apache Daffodil | daffodil.apache.org
OGF DFDL Workgroup | www.ogf.org/ogf/doku.php/standards/dfdl/dfdl
