[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [dita] Where to locate the conformance topic
FYI, The Conformance Section is required to be the last numbered section in the specification. Regards, Mary On Sep 1, 2009, at 8:35 AM, Kristen James Eberlein wrote: > 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 >> >> >> > > > > --------------------------------------------------------------------- > 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]