[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [dita] Comments on "LwDITA: An Introduction," version 2.0
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)
--------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
--
Best,
Kris
Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)
Attachment:
smime.p7s
Description: S/MIME Cryptographic Signature
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]