Sunday Apr 13, 2008
Saturday Mar 01, 2008
By Eric Armstrong on Mar 01, 2008
The DITA topic hierarchy that goes into a production system invariably does not match the desired hierarchy of documents coming out of it. And in any mixed-document system where not all docs are in the DITA format, it is invariably the case that xrefs to external documents need to resolve to different locations when documents are published in different contexts. They may require absolute links in some contexts, but be able to use relative links in others--but the relative location may change, depending on context.
This post contains a proposal for production maps. The goal is to control link generation at production time, automatically insert xrefs at authoring time, and automate link management in Content Management Systems when document names and locations change.
Since it touches the DITA standard itself, and all aspects of the tools ecosystem that surrounds that standard, any attempt at implementation will require a significant amount of time. (In the process, the proposal will undoubtedly undergo significant modification, as well.) But at this point, I don't see any alternative that will successfully divorce the output hierarchy--and link resolution--from the input hierarchy.
Monday Feb 11, 2008
By Eric Armstrong on Feb 11, 2008
> Having written up that interesting discussion, what is your gut feeling at this time?
> If you had to make an authoring recommendation to a group to make life easier
> going forward, what would it be?
Well, I found myself going back and forth, as you can tell. That post reflected two weeks of thoughts that kept surfacing after a particularly stimulating discussion. This post is an attempt to come up with an answer.[Read More]
Saturday Feb 09, 2008
By Eric Armstrong on Feb 09, 2008
This post summarizes the arguments we considered. Do they demolish the case for structured documents and reuse in a highly fluid setting like the software industry? Are they wrong in some important respect? Or do they overlook some vitally important point that makes structured document formats irreplacable?
You be the judge. And please let us know. We really want to know.[Read More]
Tuesday Jan 29, 2008
By Eric Armstrong on Jan 29, 2008
Tuesday Jan 22, 2008
Monday Jan 21, 2008
By Eric Armstrong on Jan 21, 2008
Monday Jan 14, 2008
By Eric Armstrong on Jan 14, 2008
Wednesday Dec 19, 2007
Sunday Dec 09, 2007
Sunday Nov 04, 2007
By Eric Armstrong on Nov 04, 2007
Tuesday Oct 02, 2007
By Eric Armstrong on Oct 02, 2007
Monday Sep 17, 2007
By Eric Armstrong on Sep 17, 2007
- Debra Scott: Best Executive/Manager
- Cut Payoll, Save Jobs
- Information Architecture and Planning
- Creating Topics: Where do you Draw the Line?
- Why I like Ruby: String Interpolation & "here" docs
- Docs Aren't Code
- DITA OT Customization
- Modular Docs Part 2: DITA vs. DocBook
- Modular Docs Part 1: Why You Want Modular, Topic-Oriented Documentation
- My Apache WebDAV/Windows Nightmare