[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [dita] Groups - DITA 1.3: Why Three Editions? uploaded
2.3 Growth of DITA
Addressing JoAnn's comment within this section, why don't we simply insert the straightforward summary describing the distinctions between the editions used in the DITA 1.3 specification? Specifically, the following:
Is there a clear distinction between the usage of "elements" vs. "element types"? They appear to be used synonymously within the document. Usage ought to be consistent and I note that the document as a whole bounces between using "elements" and "element
types" for what appears to be the same thing.
Since this document focuses on DITA 1.3, shouldn't any references to DITA 1.2 use past tense to avoid confusion? (Yes, I know it will continue to be used post DITA 1.3, but am thinking strictly in terms of the context of this document). For example, I
suggest rewording the following sentence:
to:
2.4 Future of DITA Given that members of OASIS have gone on the record publicly as to what they intend for the future direction of DITA 2.0, why not mention it here? At the very least mention that the intention is to introduce architectural changes and that it will not be compatible with 1.x. 4.1 What is in it?
I find the phrase "alarm clearing" relating to the troubleshooting topic type odd, though I note that the same phrase is used in the DITA 1.3 specification. Also, using "troubleshooting" to help describe the topic
type of the same name rankles the editor in me. Suggested rephrasing: "A specialized topic designed to address and solve specific problems a user may encounter."
Keith Schengili-Roberts
DITA Information Architect / DITA Specialist
IXIASOFT
825 Querbes, Suite 200, Montréal, Québec, Canada, H2V 3X1
tel + 1 514 279-4942 / toll free + 1 877 279-4942
cell + 1 647-472-7367
From: dita@lists.oasis-open.org <dita@lists.oasis-open.org> on behalf of Kristen Eberlein <kris@eberleinconsulting.com>
Sent: Wednesday, October 28, 2015 11:37 AM To: dita@lists.oasis-open.org Subject: [dita] Groups - DITA 1.3: Why Three Editions? uploaded Submitter's message
Working draft 03 -- Kristen Eberlein
|
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]