[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Where to locate the conformance topic
Elliot, sounds as if we need to discuss this. Off the topic of my head, here's what I would suggest: Overview [Unique for each of the three packages/document variations] Conformance statement Architectural Specification Language Reference This keeps "Introduction to DITA" as a component of the architectural specification. Kris ekimber wrote: > I have made a pass over the conformance statement and updated the file in > SVN. Need to work out where it should go in the overall structure--have > provided a proposal to Kristen Eberlein. My current thinking is that it > should follow the Introduction to DITA section, where that section and the > Conformance sections are then peers to the Arch Spec and Lang Ref, e.g.: > > - About the DITA 1.2 Spec > - Introduction to DITA > - Conformance > - Architectural Specification > - DITA Markup > - DITA Processing > - Specialization > - Customization > - Language Reference > > I reviewed the OASIS document on writing conformance specs. I'm not > completely happy with our current conformance spec in terms of its > organization but I think it's good enough for 1.2. > > We still need to make as much of a pass as we can over the lang ref to add > the appropriate conformance level for specific behaviors described therein. > This is no small undertaking, I realize, but it needs to be done if the > conformance clause is to have much meaning. > > At a minimum, if people can comment on that aspect of the language spec as > they are reviewing it we can try to implement the non-controversial comments > during the upcoming review period. Even creating a list of those topics that > don't need to be examined would help: there are 534 topics in the langref at > present. If we can narrow that down to say 50 that require updated > conformance language, that would make the task tractable (that's only 8 > hours at 10 minutes a topic :-). > > Cheers, > > Eliot > > ---- > Eliot Kimber | Senior Solutions Architect | Really Strategies, Inc. > email: ekimber@reallysi.com <mailto:ekimber@reallysi.com> > office: 610.631.6770 | cell: 512.554.9368 > 2570 Boulevard of the Generals | Suite 213 | Audubon, PA 19403 > www.reallysi.com <http://www.reallysi.com> | http://blog.reallysi.com > <http://blog.reallysi.com> | www.rsuitecms.com <http://www.rsuitecms.com> > > > --------------------------------------------------------------------- > To unsubscribe from this mail list, you must leave the OASIS TC that > generates this mail. Follow this link to all your TCs in OASIS at: > https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php > > > >
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]