Tag Archives: SPFE

DocBook resurgent: what it tells us about structured writing and component content management

A new XML-based content management system that is not based on DITA. Bet you didn’t see that coming. But I think it tells us something interesting about the two sides of structured writing. Tom Johnson’s recent sponsored post explains the origins of Paligo, a relatively new CCMS out of Sweden. Paligo was developed by a company… Read More »

We Must Remove Publishing and Content Management Concerns from Authoring Systems

In a comment on my Content Wrangler article, It’s Time to Start Separating Content from Behavior, Laura Creekmore said (emphasis mine): [T]his conversation has brought to mind some thoughts I’ve had recently, and I think this is an even more difficult issue. Because eventually, we’re going to come up with all the technological fixes we need to resolve the… Read More »

The Tyranny of the Terrible Troika: Rethinking Concept, Task, and Reference

Tom Johnson’s blog post Unconscious Meaning Suggested from the Structure and Shape of Help, includes a graphic showing three shapes of content: Tom Johnson’s “Shapes of Help” graphic. These three shapes are meant to represent the DITA topic triad of concept, task, and reference. I didn’t get it. As I said in a comment on Tom’s blog, I… Read More »

The Design Implications of Tool Choices

Every documentation tool has a built in information design bias. When you choose a tool, be it FrameMaker, DITA, AuthorIt, a WIKI, or SPFE, you are implicitly choosing an approach to information design. If you don’t understand and accept the design implications of your tool choice, as many people do not, you are setting yourself… Read More »

The Segmentation of Tech Comm

I was flattered that my post Technical Communication is not a Commodity was used as a catalyst for Scott Abel’s discussion with Val Swisher, Jack Molisani and Sarah O’Keefe on The Changing Face of Technical Communications, What’s Next? I had a fair amount to say in the comment stream that followed to defend my assertion that… Read More »

Introducing the SPFE Architecture

Today, I am announcing the launch of a new website, SPFE.info. [EDIT: Information on SPFE has moved to GitHub. See http://mbakeranalecta.github.io/spfe-open-toolkit/] The SPFE architecture is a design for building structured authoring systems. Why would the world, need such a thing when it already has DITA? Why have I spent the last 15 years or so… Read More »