I guess I’m doing something of a competition between #Emacs #orgmode export to #LaTeX and lovingly hand-crafted #heirloom #doctools #troff (-me).
I briefly considered an export from #orgmode to #groff (-ms) via #pandoc to see if the two approaches could possibly share anything, but that may be a gulf that is not worth crossing.
One of the macros I had coded up was to present something as a link to its entry in the appendix the first time it appeared on a new page, and ordinary text without link for subsequent mentions on the same page. While I’m sure there is a way to do this in the #TeX universe, I don’t know (yet) if it is considered sufficiently within the #LaTeX mindset to be worth attempting.
Building up from physical to logical to semantic markup feels more natural in #troff. Reaching down from #LaTeX into #TeX to perform computation in your document feels discouraged, doubly so when exporting from #orgmode. It is a wonderful method for planning, organizing, and ultimately creating a beautiful document from a single source file.
Different people want different things out of their typesetting systems. I’m glad to have spent some time in both the #troff and #TeX worlds.
One of the most important tools in #IT #documentation is the logic converter.
You can program it like a dictionary:
user-admin
developer-admin
user-developer
management-docuwriter
developer-management
the logic converter needed for
management-user
and vice versa is a fuzzy one, often, whereas any converter with -developer often needs deeper scrutiny.