RE: [dita] DITA 1.2 conformance section

["Gershon Joseph (gerjosep)" <gerjosep@cisco.com>]

Hi Jeff,

 

I think it's reasonable to expect some of the comments to be addressed only in a future spec once we fully apply the conformance to the spec. We should copy any review comments not addressed at this time to the "documentation futures" wiki here so we track them for our next release. I can't find the link just now. I'll work with Kris to get the link on our front page (if it's there I missed it).

 

 

--

Gershon

 

---

From: Ogden, Jeff [mailto:jogden@ptc.com]
Sent: Monday, January 11, 2010 5:42 AM
To: DITA TC
Subject: [dita] DITA 1.2 conformance section

I’m the last person to touch the “Conformance” section, so I think I need to try and address the comments on that section from the 3^rd review.

 

In looking over the section I see many comments that I am in sympathy with, but which I do not know how to address.  I think the problem is that the DITA TC didn’t do the work needed throughout the entire specification that would allow us to write a clear and unambiguous conformance statement.  And because doing that work would take quite a bit of effort and time that would delay the release of DITA 1.2 by several more months, we aren’t planning to do that work until DITA 1.3 or perhaps DITA 1.2.1.  And I think this means reworking the draft conformance section to address the comments that we can, but also leaving many of the comments unaddressed for now.

 

While the conformance terminology used in the DITA 1.2 spec. is far from perfect, I do think that it is much better than what we had in DITA 1.0 and 1.1 where there was essentially no conformance statement.  And we’ve made some progress in terms if using the must/should/may terminology more consistently throughout the spec., although there is much more work that should be done.

 

I’m looking for guidance from the DITA TC before I start to address specific comments from the review.  Is what I outlined above OK?  Is it OK to leave many of the comments unaddressed for DITA 1.2? Does anyone have other specific suggestions about how to address these issues?

 

To see the 3^rd review comments on the Conformance section, see:

 

  http://wiki.oasis-open.org/dita/Conformance3

 

   -Jeff