[ 
https://issues.apache.org/jira/browse/DAFFODIL-2997?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17953681#comment-17953681
 ] 

Mike Beckerle commented on DAFFODIL-2997:
-----------------------------------------

We should also
 * publish schemas to maven central so that everyone doesn't have to clone and 
publishLocal all the dependency schemas. 

> Modernize example schemas on DFDLSchemas
> ----------------------------------------
>
>                 Key: DAFFODIL-2997
>                 URL: https://issues.apache.org/jira/browse/DAFFODIL-2997
>             Project: Daffodil
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 3.10.0
>            Reporter: Mike Beckerle
>            Priority: Major
>
> A recent support experience with a new user has made it apparent that the 
> hardest part of working with Daffodil is the sorry state of the example 
> schemas.
> The example schemas on DFDLSchemas and OpenDFDL aren't strictly speaking part 
> of the Apache Daffodil project, but nevertheless are important to our users.
> We should tag them at their current versions and create github releases of 
> them.
> Then we should modernize them:
>  * Make them JSON compatible - this means following the style defined in 
> [https://cwiki.apache.org/confluence/display/DAFFODIL/DFDL+Schema+Style+Guide]
>  ** This also eliminates all use of XSD element namespaces which just 
> simplifies life for new users, namespaces are one of the most confusing 
> things about XSD/DFDL.
>  * Get rid of all the xs: prefixes by using the XSD namespace as the default 
> namespace.
>  * Test them with 3.,10.0, 3.11.0, but do NOT remove the Daffodil versions 
> they currently work with. 
>  ** If this is not possible then they need a branch to continue to support 
> the older versions of Daffodil
>  ** within reason. I'm not sure how far back these examples go, but keeping 
> examples working with Daffodil 3.4.0 is not out of the question. That version 
> has certainly been deployed in products. 
>  * Organize them into files such that they reflect the structure that the 
> giter g8 daffodil tool would create.
>  ** Do not chaange namespaced schema into the flatter structure. Some of 
> these schemas are components for sure, and others could be used as 
> components, so we should probably leave the deeper directory structure as is. 
>  * Update the version number. This is almost certainly a major version update 
> since the namespace of root elements will be changing. 
>  * Tag and create appropriate github releases from the tags
>  * Update Readme files to explain the releases. 



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

Reply via email to