OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

[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

Acknowledged. I will work on changes and maybe we can vote to approve the new version next Tuesday.Â

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)

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
+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
Carlos Evia, Ph.D.
Associate Professor of Communication
Virginia Tech
Blacksburg, VA 24061-0112

Attachment: smime.p7s
Description: S/MIME Cryptographic Signature

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]