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

-- 

--Â

Carlos Evia, Ph.D.

Associate Professor of Communication

Virginia Tech

Blacksburg, VA 24061-0112

(540)200-8201

Attachment:
smime.p7s

Description: S/MIME Cryptographic Signature