← 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)
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 →