← Prev in month ← Prev in thread

SANITY CHECK: Documenting How to Build DITA 1.2 Spec Subsets

From
Stan Doherty <>
Date
2010-02-16T13:11:13+00:00
ID
Thread
SANITY CHECK: Documenting How to Build DITA 1.2 Spec Subsets
Hi --

Before I start writing a topic documenting how our readers can build subsets of the DITA 1.2 spec for themselves, I wanted to do a quick sanity check on our assumptions and goals.

1. Distribution: DITA 1.2 sources will be downloadable from OASIS    as a .zip and/or .tar archive.    - In separate distributions, the DITA-OT and other tools providers      may choose to supplement the OASIS source archive with sets      of tool-specific build files, for example ant scripts for particular     output formats.2. Build environment: Readers should be able to use any DITA-1.2-compliant   build environment to call our DITA 1.2 DITA maps from their build scripts

   or build UI and generate one or more output formats.    - CAVEAT: When we KNOW that attempting to build a certain DITA map     requires special support tools or processing overhead, we should 

     inform readers of those requirements. Unless noted otherwise, our 

     DITA maps should load and build in general-purpose DITA-1.2-compliant

     environments.   - TESTING: We should invite competent DITA users outside the TC to       build the spec subsets in a variety of build environments. 3. Target subsets: We should document how our DITA maps support   generating the following spec deliverables:   a. DITA 1.2 Complete Spec      - Pointer to Kris' doc   b. DITA 1.2 Base Spec      - Base architecture spec      - Base language spec      - Conformance      - Appendices   c. Technical Content Spec      - TechCom architecture spec      - TechCom language spec        > Attributes        > Element Quick Reference   d. Learning and Training Spec      - L&T architecture spec      - L&T language spec   e. DITA 1.2 Architecture Spec       - Base architecture spec      - TechCom architecture spec      - L&T architecture spec      - Conformance      - Appendices   f. DITA 1.2 Language Spec      - Base language spec      - TechCom language spec        > Attributes        > Element Quick Reference      - L&T language spec

Thanx,

Stan

Stan Doherty

Director, Technical Publications

Verivue Inc.

Westford MA

← Prev in month ← Prev in thread