Work items to be completed BEFORE we start OASIS processes

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

XML grammar files

• Test RNG --> DTD and XSD transformation
• Process for adding OASIS copyright statement
• Markup for placeholder
• List of files that need the OASIS statement (all doctype shells + map.mod and topic.mod)
  
• Develop DITA 1.3 grammar files
  
• Incorporate DITA 1.2 errata
• Incorporate DITA 1.3 bug fixes
• Incorporate DITA 1.3 proposals
  
• Test DITA 1.3 grammar files

Update style sheets

• Add processing for XML mention domain
• Add processing for RFC-2119 terminology
  
• Make necessary changes for 1.3 (footer files for CHM, readme for CHM)
• Correct processing for downloadable HTML ZIP
  
• Correct handling for @rev attributes
• Ensure that we can cross reference to a <dlentry> in PDF output
  

Core editorial work

• Incorporate 1.3 content (Complete except for proposal #X)
  
• Edit 1.3 content
• Correctly markup RFC-2119 terminology
• Implement XML mention domain for archSpec
  

Spec redesign and refactoring

• Rework attributes section of LangRef topics
• Design packages (work largely done, needs TC approval)
  
• Redesign content model information
• Generate content model content
• Rework LangRef to use keys in ideal way:
• Add key-definition maps
• Remove direct addressing from navigational maps
  

Spec reviews

• How many? When?

Back log for editorial work and spec redesign

• Spec clarifications and improvements (needs triaging)
  
• Serious content edit and review of the following subject areas in the archSpec:
• Terminology
  
• Keys
• "Configuration, specialization, and constraints" + related material in "Non-normative" section
  
• Serious content edit and review of the following subject areas in the LangRef
• Subject scheme
• Classification
  
• Add topic about classification domain to archSpec
  
• Implement XML mention domain
• Index archSpec topics

Requested changes to spec

• Use ? notation instead of words to describe syntax more precisely (Jarno)
  
• All references in spec topics to specific elements should use @keyref (Jarno)
  
• Add glossary (Swope, other TechComm users)
  

Volunteer roles to fill

• Maintain style sheets: Bob Thomas
  
• Review captain: [Robert: And can we get a fancy hat for the review captain?]
  
• RFC-2119 specialist
• Indexer?
  

--
Best,
Kris

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