[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [dita-techcomm] Re: DITA 1.3 troubleshooting topic: missing a good place for diagnostic steps...
I agree with Silke’s criticism and also Bob’s proposal for the diagnosis element and making troubleSolution optional. I think these additions will help to address the issue.
Thanks and best regards,
--Scott
Scott Hudson Digital Aviation Learning & Development
Voting member: OASIS DocBook TC, Publishers SC OASIS DITA TC, Tech Comm SC, LW DITA SC, Learning Content SC OASIS Augmented Reality in Information Products (ARIP) TC Jeppesen | Digital Aviation | Boeing 55 Inverness Drive East | Englewood, CO 80112 | www.jeppesen.com
This document contains only administrative, uncontrolled data under U.S. International Traffic in Arms Regulations.
From: <dita-techcomm@lists.oasis-open.org> on behalf of Bob Thomas <bob.thomas@tagsmiths.com>
Date: Thursday, December 29, 2016 at 8:02 AM To: Kristen James Eberlein <kris@eberleinconsulting.com> Cc: "dita-techcomm@lists.oasis-open.org" <dita-techcomm@lists.oasis-open.org>, Silke Achterfeld <silke.achterfeld@ericsson.com> Subject: [dita-techcomm] Re: DITA 1.3 troubleshooting topic: missing a good place for diagnostic steps... Silke's criticisms of the troubleshooting model and of the whitepaper are valid. The code example in the whitepaper is wrong. It represents my original thinking about how to handle diagnosis. Later, I determined that it would be better to use troublesolution for
diagnosis so that writers would have access to steps through remedy. Like Silke, I am not satisfied with this solution. But, with the current model, that is the best that we can do.
I would like to make a couple of backward-compatible changes to the troubleshooting model for the next release of the technical communications package.
If anyone has thoughts about any of this, please share them.
Best Regards,
Bob Thomas
On Thu, Dec 29, 2016 at 5:40 AM, Kristen James Eberlein
<kris@eberleinconsulting.com> wrote:
Bob Thomas
+1 720 201 8260
Skype: bob.thomas.colorado
Instant messaging: Gmail chat (bob.thomas@tagsmiths.com) or Skype
Time zone: Mountain (GMT-7)
|
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]