End of the day and I'm waiting forever for my Other Computer to tell me just exactly how wrong I am. In the mean time, I figured I'd quickly share a little trick.Literate Programming Defined
Wikipedia does a better job than I ever will so go read the comprehensive definition at http://en.wikipedia.org/wiki/Literate_programming. To summarize:
This is an open letter to the DITA TC regarding something which is in my view a fatal flaw with the design of several DITA elements. The realization crystalized when I was told by someone on the DITA users email list that there is no provision for users to specify captions for their exhibits (figures, tables, etc.) or specify the text of their section headings. In short...<title> doesn't do what intuition says it will do...