OASIS Darwin Information Typing Architecture (DITA) TC

For DITA 1.2, we used the OASIS Kavi Wiki pages to conduct our spec reviews. It was painful at best ... For DITA 1.3, we've agreed that we need to find a better review tool, preferably one that enables us to view the spec draft AND the reviewers' comments aggregated together in real time. (For folks with time at IBM, something comparable to Web Review or eReview would be ideal.) Here's my initial list of our requirements -- please think whether there are one's that I have missed: Enables reviewers to view spec draft and reviewers' comments together Be able to handle DITA source authored in an evolving DITA 1.3 (If tool uses DITA-OT) Be able to easily change to a new release or patch an existing release Can folks think of potential tools that we can use? Mekon, a TC member, is willing to do a demo for us of DITAweb -- Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting LLC www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype)

I didn't find any mention of conref restrictions between general task and constrained task. http://docs.oasis-open.org/dita/v1.2/os/spec/archSpec/module-compatibility.html#module-compatibility Doesn't mention constraints at all. Should be updated to include mention of constraints, as well as intended behavior of loose validation by default, with processor option to turn on strict validation. http://docs.oasis-open.org/dita/v1.2/os/spec/archSpec/conref.html#conref Does mention constraints, but in language that is inherited from DITA 1.1, so in fact it's not referring to constraints in the DITA 1.2 sense but using the word in a generic fashion. Needs to be updated to reflect DITA 1.2 meaning of constraint, intended processing behavior, and link to specific topic on constraints and conref/generalization. http://docs.oasis-open.org/dita/v1.2/os/spec/archSpec/recognizedconstraintmechanisms.html#recognizedconstraintmechanisms http://docs.oasis-open.org/dita/v1.2/os/spec/archSpec/vocabularymodules.html#vocabularymodules http://docs.oasis-open.org/dita/v1.2/os/spec/langref/data.html#data Mentions constraints but uses word in the generic sense. Need new wording to avoid confusion. http://docs.oasis-open.org/dita/v1.2/os/spec/archSpec/domainsatt.html#domainsatt Mixes "document constraint mechanism" (meaning schema or DTD) and "constraint module" language (meaning DITA 1.2 constraints), potentially causing confusion. http://docs.oasis-open.org/dita/v1.2/os/spec/archSpec/generalize.html#generalize Uses "topic nesting constraint" along with DITA 1.2 constraint language, potentially causing confusion. Mixes use of the word constraint in a generic sense with specific sense, potentially causing confusion. http://docs.oasis-open.org/dita/v1.2/os/spec/conformance.html#ThisIsARevisionOfTheDraftDITA1.2Co-034C9AC3 http://docs.oasis-open.org/dita/v1.2/os/spec/archSpec/createConstraintsDomainSpec.html#createConstraintsDomainSpec http://docs.oasis-open.org/dita/v1.2/os/spec/archSpec/constraintsGeneralize.html#constraintsGeneralize Says that constraints MAY be checked for validity during conref. Should be updated to explicitly set default as loose validation, with processor option to turn on strict, and make it clear that the rest of the topic only applies if strict validation is turned on. Michael Priestley, Senior Technical Staff Member (STSM) Total Information Experience (TIE) Technology Strategist mpriestl@ca.ibm.com http://dita.xml.org/blog/25

We used AgileWords for another standard I work on. Unfortunately, you have to use Word as the source file, so you wouldn?t be able to do this with DITA source. Thanks and best regards, --Scott Scott Hudson         PELCO     by Schneider Electric         United States      Standards Lead   Phone:   +1 970 282 1952     Mobile:   +1 720 369 2433      Email:   scott.hudson@schneider-electric.com Sites:   pdn.pelco.com , partnerfirst.pelco.com   On Jan 14, 2014, at 6:11 AM, Kristen James Eberlein < kris@eberleinconsulting.com > wrote: For DITA 1.2, we used the OASIS Kavi Wiki pages to conduct our spec reviews. It was painful at best ... For DITA 1.3, we've agreed that we need to find a better review tool, preferably one that enables us to view the spec draft AND the reviewers' comments aggregated together in real time. (For folks with time at IBM, something comparable to Web Review or eReview would be ideal.) Here's my initial list of our requirements -- please think whether there are one's that I have missed: Enables reviewers to view spec draft and reviewers' comments together Be able to handle DITA source authored in an evolving DITA 1.3 (If tool uses DITA-OT) Be able to easily change to a new release or patch an existing release Can folks think of potential tools that we can use? Mekon, a TC member, is willing to do a demo for us of DITAweb -- Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting LLC www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) ______________________________________________________________________ This email has been scanned by the Symantec Email Security.cloud service. ______________________________________________________________________ --------------------------------------------------------------------- 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