Re: [dita-techcomm] Groups - DITA 1.2 updated for troubleshooting uploaded

Kris is correct. This is explorative work on top of DITA 1.2 towards some of our proposals around troubleshooting that we have on the table for DITA 1.3. I was unable to implement this functionality via specialization, so I hacked the 1.2 DTDs. This is actually a deliverable I committed to delivering during our SC's discussions of troubleshooting functionality (and is minuted, I believe), so it is very much just a request for folks to test drive and provide feedback, before our SC formally submits proposals to the TC.

Please note that while the element changes are targeted at the tech comm specializations, the new note type would likely be on top of the base kit (since that's how the hazard statements have been implemented in 1.2).

Gershon

On Jan 2, 2012, at 6:46 PM, Kristen Eberlein wrote:

Paul, I had the same reaction, so I downloaded the files and looked at the readme and commentary.

 

What I think this is – and Gershon, please correct me if I am wrong – is exploratory work in preparation of formal DITA 1.3 proposals to the TC regarding enhancements to the technical content piece regarding troubleshooting.

Best regards,

Kris

Kristen James Eberlein | DITA Architect and Technical Specialist | SDL Structured Content Technologies Division | (t) + 1 (919) 682-2290|

<image001.jpg>

 

Learn more about ground-breaking maturity model for product content.

www.sdl.com/maturitymodel.

 

 

 

From:  [mailto:] On Behalf Of Grosso, Paul
Sent: Monday, January 02, 2012 10:41 AM
To: 
Subject: RE: [dita-techcomm] Groups - DITA 1.2 updated for troubleshooting uploaded

 

I'm not clear on just what we're talking about here.

 

Is this just a private experiment, or are you suggesting official changes to the DITA 1.2 DTDs?

 

paul

 

 

From:  [mailto:] On Behalf Of Gershon Joseph
Sent: Sunday, 2012 January 01 10:51
To: 
Subject: [dita-techcomm] Groups - DITA 1.2 updated for troubleshooting uploaded

 

Submitter's message
Hi all,

I have updated the DITA 1.2 DTDs to add the troubleshooting functionality to address Cisco use cases 1, 2, and 5 and Avaya's use case 2. I was unable to create a specialization for this without creating an all-new task topic type -- I wanted to make the needed functionality available integrated with the existing kit, so hacking the existing DTDs was the approach I chose in the end (after trying various things via specialization for a full day...).

Please read the README.txt file in the root folder of the zip. I have also included a sample task I used to develop with, and a reference of the changes I made.

At this time I have not provided rendering stylesheets. To be honest, how these new elements are rendered are out of our scope anyway (though we certainly can make non-normative recommendations if the SC feels the need to do so).

Please report any bugs or issues to me.

Best wishes for the new year!

Cheers,
Gershon 
-- Mr. Gershon Joseph

Document Name: DITA 1.2 updated for troubleshooting

Description
Zip of the full DITA 1.2 DTD set with relevant files updated to implement
the troubleshooting functionality. See README.txt for details of the
changes. 
Download Latest Revision
Public Download Link

Submitter: Mr. Gershon Joseph
Group: DITA Technical Communication SC
Folder: Standards
Date submitted: 2012-01-01 08:50:27