Re: [EXT]: [dita-users] Visualizing reltables
toggle quoted messageShow quoted text
Well said, Wayne. Organizations use DITA in all sorts of ways for different situations.
Back on reltables specifically, I wanted to echo your earlier point that reltables do not eliminate the issues around maintaining links. They do consolidate those issues into fewer objects though, which can help.
In terms of visualizing structure, I really like the clear document that Mona shared. I would also point out though that you do not necessarily need to keep the task - concept - reference structure in your reltables, with their reciprocal links and default output. If you are info typing your topics in a different way, or if info type groups are not so relevant to display in the generated links, you can use a different structure.
Something that worked well for an implementation I did in the past was to have two columns only: source and target (there is an attribute to set on the columns to make the links behave this way). Then it is extremely clear for authors what topic links to what other one, and how.
(As to my personal preferences for links, I do feel there are cases where you need a good old hypertext type of approach: an inline link pointing to a clearly described target and saying why it's linking there. Very manual, though you can streamline and safeguard the process a bit. But high value for cases where a topic to topic link, or a purely metadata-generated one, would not be precise enough. I have done metadata-based fully automated links too and they can be great. But sometimes you can't beat a clearly labelled inline link).
On Fri, Jul 31, 2020 at 1:41 PM Wayne Brissette <wbrisett@...> wrote: