My comments are limited to revision-marked material that has
changed since the release of version 1.0:
- Page 10: Change "YAML front matter headers" to "YAML
front-matter headers". [General DITA TC style point: Hyphenate
adjectives to avoid long noun strings.]
- Page 21: Change "LwDITA authoring format" to "LwDIT authoring
formats".
- A more complete revision: Change the entire sentence to
simply read "Authors can use content references and key
reference in all LWDITA authoring formats, except the MDITA
core profile."
- Page 21: In the last sentence, add a comma after @data-conref.
- Appendix A.1: Suggestion -- In the MDITA column entries, I
think you could simply use "(Extended profile)", rather than
"(MDITA extended profile)"
- Page 28: In the note, change "conforming with" to "that
conforms with". [General DITA TC style point: We use the
syntactic "that".]
- Appendix C Revision History: I suggest that this table now
should have only two rows:
- Publication of version 1.0 (no content in the "Description
of changes" column)
- Publication of version 2.0 (Terse summary of changes between
version 1.0 and version 2.0 in "Description of changes"
column)
--
Best,
Kris
Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)
|