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: 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":
  • 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>


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