Skip to content

DITA 2.0 base specification work

Kristen James Eberlein edited this page May 6, 2025 · 21 revisions

Sections that have not yet been reviewed

What we are asking folks to do is:

  • Perform a close reading of the content. You can download a PDF from the Home page of the Wiki or use Jarno's web-based build of the DITA 2.0 draft spec.
  • Provide feedback about what needs editing and why. Examples:
    • "ID and conref attributes": The coverage of conref attributes needs to align with the wording established as a result of the TC review of conref content
  1. DITA terminology, notation, and conventions -- Stan (26 Feb), Zoe (03 March) COMPLETED
  2. DITA map processing
    1. DITA maps and their usage -- Dawn (late April), Kris
  3. DITA addressing:
    1. @id attribute -- Bob (22 March), Frank (15 Mar) COMPLETED by Bob and Frank
    2. URI-based (direct) addressing -- Stan (06 Mar), Christina (06 Mar) COMPLETED
    3. Indirect key-based addressing -- Eric (21 March), Zoe (without keyscopes, 03 Mar), Bob (29 March) COMPLETED by Zoe and Bob
    4. Context hooks for user assistance -- Stan (20 Mar), also resourceID element COMPLETED
  4. DITA processing
    1. Navigation -- Eliot (15 Mar), Frank (15 Mar) COMPLETED by Eliot
    2. Conditional processing -- Nancy, Dawn (17 Mar), Leroy (10 Mar) COMPLETED by Leroy and Dawn
    3. Branch filtering -- Eliot (01 Apr), Stan (01 Apr), Dawn (17 Mar) COMPLETED by Eliot and Stan
    4. Determining effective attribute values
  5. Element reference
    1. Domain elements
      1. DITAVAL reference domain -- Eliot (01 Apr), Stan (01 Apr), Dawn (17 Mar) COMPLETED by Eliot and Stan
  6. Attributes -- Kris (28 Feb) and Robert
  7. Conformance

Examples for conditional processing

  1. 7.4.9.1 Setting conditional processing values
    1. Goal: Show how conditional processing attributes are specified on DITA content
  2. 7.4.9.2 Simple DITAVAL document
    1. Goal: Show a simple DITAVAL document that specifies rules for filtering and flagging. Should work with the DITA content outlined in 7.4.9.1
  3. 7.4.9.3 Changing the default behavior to "exclude"
    1. Goal: Shows a simple DITAVAL document that sets the default behavior to "exclude" and then specifies two rules for inclusion
  4. 7.4.9.4 Flagging with @outputclass
    1. Goal: Are we trying to show new DITA 2.0 DITAVAL features here? If so, we might be trying to do too much in one example. We might need a simple example of using flagging with @platform that renders icons for Windows, MacOS, and Linux.
  5. 7.4.9.5 Filtering based on groups
    1. Goal:
  6. 7.4.9.6 Filtering and flagging topic content
    1. Goal: Shows DITA content with conditional processing attributes and the DITAVAL that is used with the content
  7. 7.4.9.7 Simple DITAVAL document (INCORRECT TITLE)
    1. Goal: Should show a DITAVAL document and a subjectScheme. Example: DITAVAL excludes "windows", and subjectScheme enumerates values that are types of "windows". Those types are excluded based on the subjectScheme enumeration.
  8. 7.4.9.8 DITAVAL with conditions for groups
    1. Goal:
Clone this wiki locally