[jira] [Commented] (DAFFODIL-2179) Add doc page for dfdlx extension features

["Mike Beckerle (Jira)" <ji...@apache.org>]

    [ 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)