[
https://issues.apache.org/jira/browse/DAFFODIL-2179?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=18023120#comment-18023120
]
Mike Beckerle commented on DAFFODIL-2179:
-----------------------------------------
Given the slow progress of the OGF/ISO DFDL Workgroup toward DFDL v2.0, our
Daffodil community needs official support for the various extensions to DFDL in
the Apache Daffodil implementation. Lots of DFDL schemas are being built which
depend on these.
So the nature of this documentation changes. These are no longer experimental
features being proposed to the DFDL Workgroup that are subject to change/evolve
as that group decides. These extensions need to be fully committed/supported
regardless of the DFDL Standards process.
So this may want to be a bit more formal than just a page on our web site, or
just needs to be made a more prominent page, and something that people can
easily download, as many people working on DFDL schemas are isolated from the
Internet so this needs to be something like a PDF they can download, or a
project deliverable that comes with the libraries, or something.
> Add doc page for dfdlx extension features
> -----------------------------------------
>
> Key: DAFFODIL-2179
> URL: https://issues.apache.org/jira/browse/DAFFODIL-2179
> Project: Daffodil
> Issue Type: Improvement
> Components: Documentation
> Reporter: Mike Beckerle
> Priority: Major
>
> Daffodil has numerous dfdlx features.
> These do have documentation scattered on the developers wiki under design
> notes, and intermixed with other things that aren't documentation users would
> need. Users aren't going to be able to find this.
> Since these are dfdlx features, a wiki page with links to their doc is the
> right thing, but we should have a link on the user web site that reaches this
> summary page, with links to all the dfdlx extension page wiki pages. Copious
> warnings about "subject to change without backward compatibility support."
> can then be clearly displayed, and the dfdlx features can be grouped into
> those we want people to experiement with, and those we don't (which we might
> possibly just decide not to mention at all.)
> The above is intended to add minimum work to adding a dfdlx extension to DFDL
> while giving users a clue about dfdlx features they may see in a DFDL schema,
> or need to use.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
