DocBook – FrameMaker – MediaWiki – DocBook

To my former creative colleague, while at Sun Microsystems, Wilfred Springer, now at TomTom.

Hi Wilfred,

Seeing on your blog Distributed Reflections of the Third Kind that you’re still a big fan of DocBook, allow me to pose a question.

I am in the process of writing an extensive pattern language (which I call pareltaal, for a number of reasons). Using a MediaWiki engine really helps a lot and allows collaboration among many to grow such a language. But one big drawback is that it’s easy to lose oversight. It’s hard to see the whole picture, especially with hundreds of patterns.

So, for the time being, I switched to FrameMaker, with its excellent cross reference features and its structured document capability. I’m not using the structured document powers yet, since they have a very steep learning curve for me. But I do see how it might help manage an ever evolving structured but loosely coupled pattern language. And it might also help in creating different views on the same source. Repurposing content, as they say. E.g. just a list of patlets with only the pattern name, problem and solution.

Anyway, I’m looking for a tool that allows collaborative writing and evolution of an extensive pattern language while keeping oversight and creating unlimited views on (parts of) the language. I’d like it to be able to support a lossless bidirectional link between, say, FrameMaker and MediaWiki.

Thoughts?

Succes en plezier,

Martien.

Author: Martien van Steenbergen

Martien is a Visioneer and touched by software.
people | software | happiness

2 thoughts on “DocBook – FrameMaker – MediaWiki – DocBook”

  1. I think I see where you’re going with this. It is a little related to doing planguage right. Not sure if you know planguage, but if you don’t, then you are probably gonna like it.

    While searching for the ultimate tools to do planguage right, we considered many different options, including wiki (impossible to extract intent) and XML (to hard without tools supporting cross-referencing).

    … and I am sorry to say I haven’t found the answer yet.

Leave a Reply