Re: *Minor* Error in DITA 1.3 ditavelref Example Code

[Kristen James Eberlein <kris@eberleinconsulting.com>]

I'll put it on the agenda. We don't have to spend time on it, but the minutes should reflect that it was handled at the 26 April 2016 TC meeting.

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 682-2290; kriseberlein (skype)

On 4/26/2016 10:25 AM, Robert D Anderson wrote:

Good catch - I think it works better with that comment restored. Kris, is there a reason to spend TC time on this (I think not?), or should I just add it to the errata list?

Regards, Robert D. Anderson DITA-OT lead and Co-editor DITA 1.3 specification, Digital Services Group
E-mail: robander@us.ibm.com Digital Services Group
11501 BURNET RD,, TX, 78758-3400, AUSTIN, USA

Keith Schengili-Roberts ---04/26/2016 09:16:50 AM---I have been doing some research on ditavalref, and noticed what I believe to be a minor error in the

From: Keith Schengili-Roberts <keith.roberts@ixiasoft.com>
To: Kristen James Eberlein <kris@eberleinconsulting.com>, Robert D Anderson/Rochester/IBM@IBMUS
Date: 04/26/2016 09:16 AM
Subject: *Minor* Error in DITA 1.3 ditavelref Example Code

---

I have been doing some research on ditavalref, and noticed what I believe to be a minor error in the explanation as to how the code will run.

The section is: "2.4.4.6.2 Example: Multiple <ditavalref> elements on a branch" (http://docs.oasis-open.org/dita/dita/v1.3/os/part1-base/archSpec/base/example-multiple-ditavalref.html).

When explaining what will happen during processing in the first example, it says that between "do-stuff.dita" and "cleanup.dita" there are "...more topics and nested branches...". But the thing is, there are no other topics referenced in the source code listed in Figure 1. The same applies to the subsequent MacOS and Linux branches.

In the original proposal (https://www.oasis-open.org/committees/download.php/51653/13059a-BranchFilter-Stage3.html) there *is* a line after the topicref for "do-stuff.dita" that says:

<!-- more topics and nested branches -->

But this line is omitted in the example in the final spec, which is what throws off the explanations.

It is *minor* error, but it took me a couple of readings and a double-check of the proposal before I confirmed my suspicion.

Something else to add to the errata.

Cheers!
-

Keith Schengili-Roberts
DITA Information Architect / DITA Specialist

IXIASOFT
825 Querbes, Suite 200, Montréal, Québec, Canada, H2V 3X1
tel + 1 514 279-4942 / toll free + 1 877 279-4942
robertsk@ixiasoft.com / www.ixiasoft.com



Interested in attending? Visit our event website for more information.