Fourth review: 12 April 2010 -- 30 April 2010

This Wiki page is designed to serve as a portal to Wiki pages for the fourth review of the DITA 1.2 specification, 12 April 2010 to 30 April 2010.

Download draft #4

CHM version: http://www.oasis-open.org/committees/download.php/37251/dita1.2-spec-9-April-2010.chm
XHTML version: http://www.oasis-open.org/committees/download.php/37252/dita1.2-spec-xhtml-9-April-2010.zip
PDF version: http://www.oasis-open.org/committees/download.php/37260/dita1.2-spec-9-April-2010.pdf

DITA source: <add public URL here>
DTDs: http://www.oasis-open.org/apps/group_public/document.php?document_id=37239
XSDs: http://www.oasis-open.org/apps/group_public/document.php?document_id=37189

If you have problems opening the CHM:

  1. Save the CHM file to your local system.
  2. Right-click the CHM file, and then click Properties.

  3. Click Unblock, and then click OK. The contents now are displayed when the file is opened.

See http://support.microsoft.com/kb/902225/ for more information.

Items for reviewers to consider

Wiki pages for review #4

TOC, Overall Content

Overview of the DITA 1.2 specification

Architectural specification

Language reference

Conformance

Appendices

Review status: Reviewer's progress

This table tracks people's progress in completing their review assignments.

(./) = All reviews completed
/!\ = Only one review outstanding
{X} = Few or no reviews completed
||<tablewidth="1000px" tableheight="252px"> Section || Content collection ||Reviewers || Estimated
completion
|| Status ||

TOC, information architecture

Eberlein (completed 3 May)

(./)

Overview of the DITA 1.2 specification (1 topic)

Architectural specification (1 topic)

Base architecture (1 topic)

Introduction to DITA

Introduction to DITA (6 topics)

DITA markup

DITA markup (1 topic)

DITA topics (10 topics)

DITA maps (6 topics)

DITA metadata (10 topics)

Hamilton, Complete 28 Apr
Helfinstine, complete 30 April

(./)

Processing

DITA processing (1 topic)

Hackos (Done 30 April
Grosso (Done 2010-04-16, 2 comments on DITA addressing
Nevin (Finished 29 Apr)
Day

(./)

Module compatibility and the domains attribute (1 topic)

Navigation behaviors (1 topic)

DITA linking (3 topics)

DITA addressing (9 topics)

Content inclusion (conref) (1 topic)

Conditional processing (profiling) (1 topic)

Chunking (1 topic)

Printing (1 topic)

Translation (3 topics)

Configuration, extension, & contraints

Configuration, specialization, and constraints (1 topic)

Helfinstine/Goolsby (30 April)
Anderson (30 April)
Joseph (28 April)
Day

(./)

Overview of DITA extension facilities (3 topics)

Configuration (Document type shells) (3 topics)

Specialization (1 topic)

Vocabulary modules (1 topic)

Requirements for specialized element types and attributes (1 topic)

Element type specialization hierarchy declaration (the class attribute) (1 topic)

Domain usage declaration (the domains attribute) (1 topic)

Generalization (1 topic)

Attribute generalization (1 topic)

Specializing foreign or unknown content (1 topic)

Specialization module coding requirements (11 topics)

Constraints (5 topics)

Technical content

Technical content architecture (1 topic)

Overview of the DITA 1.2 Specification: Technical Content (1 topic)

Technical content: Information types (9 topics)

Topic domains: Technical content (1 topic)

The xNAL domain (1 topic)

Learning and training

Learning and training architecture (1 topic)

Overview and assumptions (6 topics)

Language reference (1 topic)

Base elements

Base elements (1 topic)

Topic elements (1 topic)

Basic topic elements (12 topics)

Body elements (40 topics)

Table elements (12 topics)

Related links elements (6 topics)

Map elements

Map elements (1 topic)

Basic map elements (11 topics)

Map group elements (8 topics)

Metadata elements

Metadata elements (1 topic)

Prolog elements (28 topics)

Indexing group elements (6 topics)

Delayed conref resolution elements (4 topics)

Domain elements

Domain elements (1 topic)

Hazard statement elements (7 topics)

Typographic elements (7 topics)

Utilities elements (5 topics)

Classification elements

Classification elements (1 topic)

Subject scheme maps (20 topics)

Classification domain elements (9 topics)

Specialization elements (10 topics)

Legacy conversion elements (2 topics)

DITAVAL elements (8 topics)

Technical content

Technical content elements (1 topic)

Concept elements (4 topics)

Task elements (28 topics)

Reference elements (14 topics)

Glossary elements (23 topics)

Bookmap elements (64 topics)

Domain elements (1 topic)

Machine-industry task domain (27 topics)

Programming elements (27 topics)

Software elements (9 topics)

User interface elements (6 topics)

xNAL domain elements (28 topics)

Learning and training

Learning and training elements (1 topic)

Learning and training topic elements (13 topics)

Learning and training map domain elements (10 topics)

Learning and training interactions domain elements (12 topics)

Learning and training metadata elements (17 topics)

Other learning and training elements (1 topic)

Common learning interactions elements (24 topics)

Common learning content elements (74 topics)

Attributes

Attributes (1 topic)

Grosso (Done 2010-04-16, no comments)
Doherty (Done, April 26, 2010)

(./)

Commonly referenced attribute groups (11 topics)

Complex attribute definitions (13 topics)

Element quick reference (5 topics)

Conformance (1 topic)

Appendices

Appendices (1 topic)

Doherty (Done April 26, 2020)
Hamilton (Done April 29, 2010),
Joseph (Done 29 April, 2010)

(./)

Acknowledgments (1 topic)

Changes from previous versions (3 topics)

Migrating from DITA 1.1 to 1.2 (1 topic)

DITA MIME type (1 topic)

Considerations for generalizing <foreign> elements (1 topic)

Element-by-element recommendations for translators (1 topic)

DITA module and shell implementation reference (4 topics)

Processing interoperability considerations (1 topic)

Specialization design, customization, and the limits of specialization (1 topic)

Review status: Handling review comments

This table tracks progress in handling review comments

(./) = All review comments addressed
>:> = 67-99% of review comments addressed
/!\ = 34-66% of review comments addressed
<:( = 1-33% of review comments addressed
{X} = No review comments addressed

Eberlein, 3 May 2010: I have removed rows for sections without Wiki comments; I also added categories to make table easier to read.

Category

Section

Responsible party

# of Comments

Status

Comments

TOC, Overall Content

Eberlein

2

(./)

Introduction to DITA
1 comment

Introduction to DITA (6 topics)

Eberlein

1

(./)

DITA markup
14 comments

DITA maps (6 topics)

Eberlein

3

(./)

DITA metadata (10 topics)

Eberlein/Anderson

11

(./)

DITA processing
104 comments

DITA processing (1 topic)

Joseph

3

(./)

Module compatibility and the domains attribute (1 topic)

Joseph

2

(./)

Navigation behaviors (1 topic)

Joseph

7

(./)

DITA linking (3 topics)

Joseph

10

(./)

DITA addressing (9 topics)

Joseph

35

(./)

Content inclusion (conref) (1 topic)

Joseph

4

(./)

Conditional processing (profiling) (1 topic)

Joseph

4

(./)

Chunking (1 topic)

Joseph

21

(./)

Printing (1 topic)

Joseph

1

(./)

Translation (3 topics)

Joseph

16

(./)

Configuration, extension, and constraints
97 comments

Configuration, specialization, and constraints (1 topic)

Kimber

1

(./)

Overview of DITA extension facilities (3 topics)

Kimber/Eberlein

4

(./)

Configuration (Document type shells) (3 topics)

Eberlein

23

(./)

Specialization (1 topic)

Eberlein

3

(./)

Vocabulary modules (1 topic)

Eberlein

4

(./)

Requirements for specialized element types and attributes (1 topic)

Eberlein

2

(./)

Element type specialization hierarchy declaration (the class attribute) (1 topic)

Eberlein

9

(./)

Domain usage declaration (the domains attribute) (1 topic)

Eberlein

5

>:>

1 comment in progress (example may not be valid; checking with Robert)

Generalization (1 topic)

Eberlein

11

(./)

Attribute generalization (1 topic)

Eberlein

1

(./)

Specializing foreign or unknown content (1 topic)

Kimber

4

(./)

Specialization module coding requirements (11 topics)

Kimber

22

>:>

1 comment in progress (checking with Robert whether action required)

Constraints (5 topics)

Eberlein

14

/!\

7 comments not addressed

Learning and training
2 comments

Learning and training architecture (1 topic)

Hunt

1

(./)

Done

Overview and assumptions (6 topics)

Hunt

1

(./)

Done

Language reference
22 comments

DITAVAL elements (8 topics)

Anderson

1

(./)

Done

Technical content elements (1 topic)

Anderson

1

(./)

Done

Concept elements (4 topics)

Anderson

2

(./)

Done

Task elements (28 topics)

Anderson

4

(./)

Done

Reference elements (14 topics)

Anderson

1

(./)

Done

Bookmap elements (64 topics)

Anderson

2

(./)

Done

Domain elements (1 topic)

Anderson

1

(./)

Done

Machine-industry task domain (27 topics)

Anderson

4

(./)

Done

Programming elements (27 topics)

Anderson

2

(./)

Done

Commonly referenced attribute groups (11 topics)

Anderson

6

(./)

Done

Complex attribute definitions (13 topics)

Anderson

4

(./)

Done

Appendices
74 comments

Changes from previous versions (3 topics)

Eberlein

16

(./)

Migrating from DITA 1.1 to 1.2 (1 topic)

Eberlein/Joseph

9

(./)

DITA MIME type (1 topic)

Eberlein

3

(./)

Considerations for generalizing <foreign> elements (1 topic)

Eberlein

2

(./)

Element-by-element recommendations for translators (1 topic)

Eberlein

3

(./)

DITA module and shell implementation reference (4 topics)

Eberlein/Joseph

33

(./)

Processing interoperability considerations (1 topic)

Eberlein

5

(./)

Specialization design, customization, and the limits of specialization (1 topic)

Eberlein

3

(./)

TechReview4 (last edited 2010-05-18 15:13:42 by keberlein)