← Prev in month ← Prev in thread
Next in thread → Next in month →

symbols for <startflag>/<endflag>? (was Re: [dita] Feedback about "Lightweight DITA: An Introduction" change-marked draft)

From
Alan Houser <>
Date
2018-01-18T19:46:18+00:00
ID
Thread
symbols for <startflag>/<endflag>? (was Re: [dita] Feedback about "Lightweight DITA: An Introduction" change-marked draft)
Hi Kris,

    
Thanks for your thorough review! I had one technical issue with
      the build. I began with the following ditaval directive:

    

    
  <revprop action="" color="red"
      val="public-review-01">

         
      <startflag><alt-text>►</alt-text></startflag>

         
      <endflag><alt-text>◄</alt-text></endflag>

        </revprop>

    
My (FOP-based) PDF build rendered the symbols as octothorps, so I
      removed the <startflag> and <endflag> directives from
      the ditaval.

    
I concur that symbols are desirable for marking changes. If you
      or anybody else knows the cause of the behavior I'm seeing, I
      would be grateful.

    

    
-Alan

    

    

    
On 1/18/18 2:21 PM, Kristen James
      Eberlein wrote:

    

    
      
      
        
The subtitle should be "Committee Note 01"

        

        
The date needs to be the date on which the TC will vote on
          the committee note: 23 January 2018

        
The file name should be "LwDITA-v1.0-cn01". (The easiest way
          to handle this is to rename the DITA map.)

        
In "Specification URIs":

        
          
The content currently in "This version" should move to
            "Previous version".

          
The URLs for "This version" need to be as follows (changes
            indicated in red):

          
            
http://docs.oasis-open.org/dita/LwDITA/v1.0/cnd01/LwDITA-v1.0-cn01.html (Authoritative)

              

            
http://docs.oasis-open.org/dita/LwDITA/v1.0/cnd01/LwDITA-v1.0-cn01.pdf

          
        
        
Use symbols for
              the revision marking, in addition to color. This is
              important for TC members who are color blind or who are
              printing the document out on a black and white printer.
              I'd look at the DITAVAL files that we use for the errata
              version of the spec.

        
There are extra
              spaces before some instances of the word "component".

        
I think changing
              instances of the word "elements" to "components" makes
              this document read VERY strangely. I am not on-board
                with this change, especially when the references
                are to XDITA or XDITA.

            

      
      
Best,

        Kris

        

        Kristen James Eberlein

        Chair, OASIS DITA Technical Committee

        Principal consultant, Eberlein Consulting

        www.eberleinconsulting.com

        +1 919 682-2290; kriseberlein (skype)

        

      

    
    <snip>
← Prev in month ← Prev in thread
Next in thread → Next in month →