Re: [dita] Comments on "LwDITA: An Introduction," version 2.0

On Tue, Sep 18, 2018 at 10:14 AM Kristen James Eberlein <kris@eberleinconsulting.com> wrote:

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)

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

dita message