I don't quite follow this, but it sounds like Lee is suggesting
that anchorref values need to be authored differently for Eclipse output than
for other outputs. If I am reading that correctly, that cannot be the case.
There should be no need for authors to author things differently for different
outputs, and the DITA spec should certainly not change how URI references work
for different outputs.
I look forward to having this explained more clearly to me.
paul
From: Gershon Joseph
(gerjosep) [mailto:gerjosep@cisco.com]
Sent: Thursday, 2009 July 30 13:59
To: Robert D Anderson
Cc: DITA TC
Subject: [dita] FW: [dita-comment] Misleading example in anchorref
attribute description of DITA 1.1 langspec
Can we address this as part of the current DITA 1.2 spec draft 2
preps?
Hope you're feeling better.
From: Lee Anne Kowalski
[mailto:lee_anne_kowalski@yahoo.com]
Sent: Wednesday, July 29, 2009 6:59 PM
To: dita-comment@lists.oasis-open.org
Subject: [dita-comment] Misleading example in anchorref attribute
description of DITA 1.1 langspec
Hello,
I am assuming that the dita-comment list is the appropriate way to raise this
type of item. If it is not, please let me know.
On the following page of the DITA 1.1 language spec posted at OASIS:
http://docs.oasis-open.org/dita/v1.1/CD01/langspec/langref/map.html
The anchorref example in the sentence starting "For example," is
misleading for Eclipse navigation integration. The example code shown as
anchorref="map1.ditamap/a1" does not work in the Eclipse help
navigation at Eclipse runtime.
If I change the anchorref code to be:
anchorref="../map1_id/map1.ditamap#a1"
Then the example will work for a map1.ditamap that has a map element with id
attribute, id="map1_id".
At the very least, the slash shown in front of the a1 should be changed to a
hash (#) for that coding to work in the Eclipse help navigation.
A simple fix might be to add a sentence that states clearly an anchorref
example for Eclipse help, in contrast to an example for other runtime
formats.
This item has caused confusion for at least two teams that I am aware of, and
has affected their productivity. Updating the example in the page on the web
site would be a huge help to us.
Sincerely,
Lee Anne Kowalski
|
|