Structured Writing: Backsliding into the Media Domain

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 ...

Structured Writing: Writing in the Document Domain

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 ...

Structured Writing: Writing in the Media Domain

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 Three Domains of Content Structure

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 ...

What is Structured Writing?

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 ...

LavaCon Session: Nick Kellet on Why Short is Good

You would think that this distinction between search as feature and search as market would have been clear to me. But it wasn’t. It was a revelation. That, I think, is the best kind of insight that a speaker can give you: not to see something entirely outside your experience, but to make you see the thing that has been in front of your face all along. Continue reading ...

Diversity Trumps Ability: Five Consequences for Tech Writers

Adapting ourselves to the Web is not just about learning to write for online or format content for mobile. It is about learning to accept our role as one voice in the choir, as one contributor to a valuable diversity of experiences and points of view. In a world where diversity trumps ability, the capacity to embrace, develop, and contribute to diversity may be our most valuable ability. Continue reading ...