I am somewhat concerned about moving these from inline to an info
element. I have found that having keywords in the info element
frequently leads to them being out of date as information is
modified and the keywords associated with them are not updated.
If a paragraph moves from one topic to another, the keywords
frequently get left behind in the info element. If it is deleted,
they do not always get deleted with it. I realize this is a
problem with the authoring process, but it is exacerbated by
separating the tag representing the cross reference from the
content it describes. Unless an info element is attached to
each paragraph, it becomes harder to assure that the cross
references represented by the relatedlink follows content as it
is altered, moved, or removed.
I guess it is a usability issue. I find that indexterms are
much more robust than keywords in our content because they are
embedded in the content they represent rather than remotely
located from it. Adjacency is a strong principal in interface
design and general human factors.
Regards,
Larry Rowland
Original Message-----
From: Bob Stayton [mailto:bobs@sagehill.net]
Sent: Monday, November 23, 2009 11:05 AM
To: Scott Hudson; Norman Walsh
Cc: docbook-tc@lists.oasis-open.org
Subject: Re: [docbook-tc] proposal: add relatedlink element to topic
Putting relatedlink elements in info is fine with me. Should we create a
relatedlinks wrapper for them, or allow a random scattering of relatedlink
elements in info?
Bob Stayton
Sagehill Enterprises
bobs@sagehill.net