Draft of conformance clause for DITA 2.0 #7
Merged
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Our DITA 1.x conformance clause was troublesome. It had 3 sections: implementations, documents, and grammar files. These sections were generally descriptive, providing some rules, and laying out a few new concepts and terminology related to conformance. Feedback from OASIS TAB indicated a strong preference for conformance clauses to (instead) be a clear list of rules that must be followed in order to conform with the specification, along with links to those rules.
This is a first draft of a conformance clause for DITA 2.0 which attempts to respond to the TAB comments:
-- If you use the OASIS grammar files, you must follow all rules in those files + descriptive rules for the elements in the spec. I took this approach from the DocBook conformance clause, which states "A conformant DocBook V5.1 document must be valid according to both the grammar and the assertions."
-- If you use a custom document type shell, the shell must also follow the rules in [that section]. If the shell uses constraints, those must also follow the rules in [that section].
-- If you use specialization, it must also follow the rules in [those sections].