dita — archive

From: Kristen Eberlein
To: [email protected]
Date: Tue, 07 Mar 2023 15:24:00 -0000

The open comments in review E.2, “Troubleshooting, take two” pertain to the <responsibleParty> element, and I could use some help in redrafting the short description for the element AND developing some new examples. Context: For DITA 2.0, we are broadening how we define the element. It needs to cover both of the following: Who should be performing the work – the responsible person or team Any prerequisites that folks reading the troubleshooting topic should be aware of, for example, admin privileges or whether performing the work would void a warranty. Basically, the element needs to serve the same functionality that the <prereq> element serves for a task topic. Where the <responsibleParty> element is located in a troubleshooting topic <troubleSolution> <remedy> <title> Remedy </title> <responsibleParty></responsibleParty> <steps> <step> <cmd></cmd> </step> </steps> </remedy> </troubleSolution> Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Owner, Eberlein Consulting LLC [email protected] Skype: kriseberlein; voice: +1 (919) 622-1501