Second review of the DITA 1.3 spec: 13 - 27 October 2014

[Kristen James Eberlein <kris@eberleinconsulting.com>]

DITA 1.3 specification documents

I have uploaded the draft DITA 1.3 spec to Kavi in the following versions: CHM, XHTML, and PDF. You can get the ZIP at https://www.oasis-open.org/committees/download.php/54295/review-2-draft.zip

Please be aware of the following points:

• Draft comments are enabled.
• The cover page and footer information has NOT been updated.
• DITA 1.2 errata and DITA 1.3 changes are flagged in the CHM and XHMTL in brown text; the PDF has black bars in the margins
  
• The PDF contains an index, but it is unlikely that we will ship one for DITA 1.3.
  

Objectives of the review

Here are goals for this review:

•     Review the rework of the material in the "Indirect key-based addressing section." Is there related material in other topics that must be aligned?
•     Review the material in the "Branch filtering" section.
•     Review the material in the "Subject scheme maps and their usage" section. (For extra credit, think about how the subject scheme and classification material in the Language Reference should be reworked.)
•     Consider draft comments. Can we address the points that are raised in the comments?
•     Specific reviewers (see the assignments in https://wiki.oasis-open.org/dita/1.3-spec-review-#preview) to consider the items in the Trello board for "Spec clarifications and improvements," and suggest concrete ways to resolve the items.
•     Suggest short descriptions for topics that lack them.
•     All proposal owners who did not complete their reviews during the first review must do so now.

If you have limited time, please focus on the "Processing" section. Avoid the "Constraints" section as we know that needs in-depth work from a small team (although we will ask specific reviewers to look at this section).

And of course, keep your eyes out for places where we need to use normative terminology or make the wording about XML grammar files generic.

Review tool

We are again using Mekon's DITAweb application. (Thank you, Mekon, for hosting the application and doing development work to build the Revisions widget. We really, really, appreciate it!)

Everyone's user ID is their first initial followed by their family name, for example, keberlein. If you used DITAweb for the first review, your password is the same. If you do not have a DITAweb account, contact me and I will arrange one.

--
Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting LLC
www.eberleinconsulting.com
+1 919 682-2290; kriseberlein (skype)