Based on conversations with Carlos Evia, Alan Houser, and Robert Anderson, I made revisions to the LwDITA committee note.
Alan or others, can you do a sanity check?
Tom, your e-mail hit the list after I'd done the rework. I think
"markup structures" is a better (and more accurate) way to refer
to "LwDITA components".
Kris
Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 682-2290; kriseberlein (skype)
Regarding this comment from Kris:
> 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.
I assume that was meant to say XDITA or HDITA, which both have elements. But beyond that ... I think I have to agree that while "components" sounds accurate conceptually, when I read it in context, it's kind of jarring. That's especially true where we refer to "a subset of components in DITA 1.3" and I thought DITA 1.3 components were literally the different packages + grammar zip -- see the usage under "Additional artifacts":
http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part1-base/dita-v1.3-errata01-os-part1-base-complete.html
There are a few other uses -- our terminology topic lays out terms that "define components of the DITA standard". There's an actual element named <component>. Almost all remaining uses in the spec are part of examples, mostly for the delayed-conref-resolution domain. There is only one other instance I can find that seems more in line with the usage in the committee note, in the topic about single sourcing, which refers to "document components including paragraphs, lists, and tables":
http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part1-base/archSpec/base/single-sourcing.html#single_sourcing
Regards, Robert D. Anderson
DITA-OT lead and Co-editor DITA 1.3 specification,
Digital Services GroupE-mail: robander@us.ibm.com
Digital Services Group11501 BURNET RD,, TX, 78758-3400, AUSTIN, USA
Kristen James Eberlein ---01/18/2018 01:21:58 PM---The subtitle should be "Committee Note 01" The date needs to be the date on which the TC will vote o
From: Kristen James Eberlein <kris@eberleinconsulting.com>
To: dita@lists.oasis-open.org
Date: 01/18/2018 01:21 PM
Subject: [dita] Feedback about "Lightweight DITA: An Introduction" change-marked draft
Sent by: <dita@lists.oasis-open.org>
Best,
- 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.
Kris
Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 682-2290; kriseberlein (skype)
On 1/18/2018 1:21 PM, Carlos Evia wrote:
Document Name: Lightweight DITA: An Introduction
Description
Marked version with changes implemented after public review #1. Thanks to
Alan Houser for the transform.
Download Latest Revision
Public Download Link
Submitter: Dr. Carlos Evia
Group: OASIS Darwin Information Typing Architecture (DITA) TC
Folder: Drafts
Date submitted: 2018-01-18 10:20:42
--------------------------------------------------------------------- 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
