Helping the world explore and understand content management and technical communication
Human beings can execute algorithms. Indeed, computer programs often replace human beings as the performers of algorithms. This is one of the reasons we turn to structured writing, so that we can hand over the tedious and exacting algorithms of writing and publishing to machines. Continue reading ...
Structured writing is not about assisting the machine. It is about enlisting the machine to assist the writer. And where the writer need assistance most of all is with quality. Continue reading ...
The management domain intrudes on structured writing, because, while the subject, document, and media domains are all about recording the content itself, the management domain is not about the content, but about the process of managing it Continue reading ...
You can write a recipe in the document domain. However, there are specific constraints on the format of a recipe that this approach neither follows nor records. If we want to create different document structures for different media, recording our content in the subject domain gives us that flexibility. Continue reading ...
Moving to the document domain can allow you to factor out many of your media domain constraints, creating greater consistency at less cost, as well as providing a range of automation and validation options for your content. But it is all too easy to authors to backslide into the media domain, undoing all of these benefits. Continue reading ...
The simplest reason for moving to the document domain is to enforce media domain constraints that are hard to enforce in the media domain itself. In fact, one of the consistent patterns in structured writing is moving to the next domain to enforce, or factor out, constraints in the previous domain. Continue reading ...
At its most basic, a hand guiding the pen over paper or chisel over stone is working in the media domain through handwritten-bitmapdirect physical interaction with the media. But this is not structured writing in the sense we mean it here. No computable structures are involved because no computer is involved. Continue reading ...
The process of creating and delivering content consists of translating ideas (stuff someone thinks or knows) into concrete physical form that can be read (dots of ink or pixel on a page or screen). The writing and publishing process is all about how we get from ideas in a head to dots on a page. Continue reading ...
The phrase “structured writing” seems to demand something in the way of definition, not because its meanings are obscure, but because they are so varied. This is a product of diversity of interests, not lack of definition. My definition is a declaration of my interests; no more. Continue reading ...