23 thoughts on “Content Engineering is Not Technical Writing”

  1. I disagree on one point: reducing the degree of variation does not automatically improve quality. That may be true in machining and assembly-line production, but it is not a given in documentation. You can standardize and homogenize things so far that the result is boring. Even technical people don’t like reading something that bores them. People become mentally numb and stop actually thinking about what they’re reading when they have to read the same thing over and over and over and over and over and over and…And some people will go the other way and be ready to scream and throw the manual out a window when they read “Step 1: Start the…” for the 89th time.

    In documents, even technical documents, a little bit of variation can make the results easier on the reader by preventing monotony.

    1. Thanks for the comment Keith.

      As a writer, I sympathise with your point, but looking at the total content strategy picture, I’m afraid I can’t agree with it.

      For one thing, people don’t read tech comm to be entertained. They read it to solve a problem, and their fundamental engagement is with the problem, not the text. They want a text that is useful, not one that is entertaining.

      For another, the cost of the variability you are talking about is extraordinarily high. It increases costs all down the line from content creation to content management to translation. It can create confusion for readers, particularly for those who are not reading in their native language.

      So while variability is a desirable part of literary style (at least in English, with its monstrous vocabulary) it really is too wasteful, and too incidental to the value being created, to be considered desirable in tech comm.

    2. One thing that certainly needs to be ‘standardized and homogenized’ is terminology. I observe in general writers a – probably unconscious – tendency to ‘synonymize’. For example, one sentence refers to ‘the payment’; the next to ‘the transaction’ – are these the same? Probably, but who can tell? If consecutive statements refer to ‘the payment’ (and no ‘it’, either), then that’s good, not boring.

      1. My favorite is when I read release notes that include a change to 3 different menu options. You can tell 3 different people wrote the release notes when you see something like this:

        [Menu Option A] – Modified the program to add XYZ functionality.
        [Menu Option B] – Changed the program so that XYZ is available when …
        [Menu Option C] – Altered the program to allow XYZ …

        I would love to read “boring” release notes so I don’t have to figure out the the difference between “modified”, “changed” and “altered”?

        1. Thanks for the comment, Paul.

          Yes, I’ve seen that a few times. This is the sort of thing I try to factor out when I create a structured writing system. These are boilerplate sentences that just need a variable substitution for XYZ. Why make authors type them over and over?

      2. Thanks for the comment, Roy.

        I agree. I don’t know if this is unique to English prose style, where we have so many close synonyms to choose from, but people trained to write in English tend to have this drummed into them both by teachers and by example. We don’t like to repeat the same word, so we choose synonyms, sometimes several in a short passage. Fine for literature; bad for tech comm.

        Too little is said about how much writers need to unlearn before they can become good technical writers. Another thing they need to unlearn is the idea that a writer is supposed to grab and hold the reader’s attention for as long as possible. Again, fine for literature, but in tech comm the goal is to get them back to work as soon as possible, not to keep them reading.

        1. This is one place where starting out “technical” helps. Engineers don’t worry about whether using the same size screw, washer or nut over and over again is repetitive.

  2. I don’t disagree with the idea. I just hate that title because I think it SOUNDS like an attempt to rebrand technical writing, and I think the fact that you need to defend it like this within our own profession proves that I’m right about that.

    Our profession is based on the clear delivery of concepts and information. A title that is confusing even to us is bound to be even more confusing to outsiders.

    1. Thanks for the comment, Gene.

      It is certainly true that the constant (and uniformly unsuccessful) attempts to rebrand technical writing have left many in the field hypersensitive to yet another name for the same old profession. (In this respect, I think it is apt to be far more confusing to insiders than to outsiders who have no idea technical writing — if they have even heard of it — is ever called anything else.)

      Be that as it may, content engineering seems to be the term that has stuck. It has certainly been in use for over a decade and seems to have been independently coined in more than one place. (I was midwife to one of occasions where it was coined, so I bear some responsibility.)

      And because we are now increasingly dealing with larger integrated content sets which cannot be successfully wrangled using traditional craft methods, I think we are going to be hearing the term more often.

      Actually, as the term becomes more widely used and more widely recognized, perhaps the confusion with technical writing will disappear.

  3. I think the fact that a discussion about content engineering has the resonance (positive or negative) that it has is indicative… Exciting times, and big changes to how we think about content!

    Since Ted Nelson brought hypertext into the popular vernacular, we’ve been confronted with content that is more than a static artifact. For static content artifacts, management and control is largely social — determining incentives to produce (royalties), production and distribution chains (lots of people moving STUFF), controlling access (book burning/banning), freeing access (libraries usually funded socially), and so on.

    When content is increasingly dynamic, that changes the equation. You either manage those dynamics or you get managed by them. Authority is hard to pin down, filter bubbles proliferate (http://www.thefilterbubble.com/ted-talk), content piles up, and it’s more difficult to tell knowledge from rumor, information from data, fact from fiction.

    All that is highbrow, but we have immediate and concrete issues. Content dynamics should match situational dynamics. A developer wants different dynamics than a casual reader. Marketing wants different dynamics than tech support. Some choices are stylistic and aesthetic, but even style serves a distinct purpose. Graphic designers know that, and balance legibility with impact when designing a message. When designing content, we now have to balance dynamics with whatever else we throw into the mix.

    You can imagine all the dynamics you want, but to realize them you need engineering. Just like engineering is required to mass produce color copy — first in the printing industry, then later in the desktop printer industry — engineering is required to have your content:
    * Perform visual dynamics (show/hide, blink, link, etc.)
    * Include other media (video/audio)
    * Support collaboration (reader inputs)
    * Support re-use in all its flavors (role-based dynamics)
    * Incorporate on-the-spot changes and system states (IETMs)
    * Execute processes (forms)
    * Other???

    All these things are possible, now more than ever before. It takes project managers or creative staff to work out the WHY — Why bother implementing this stuff? What’s the goal? It takes engineers to work out the HOW, including methodology, maintenance, ongoing process, and cost. But the point is, we now have lots of reasons to ENGINEER our content. And maybe we have enough reasons to justify a separate discipline — we may as well call it Content Engineering, eh?

    1. Thanks for the comment, Chris.

      I agree entirely. And I think you provide a very important insight on why content engineering is increasingly important. Traditionally, the final format in which content was presented was determined by the pen of the author inscribing the final form on parchment. Ever since, we have been progressively moving the determination of final form further and further away from the author. The printing press moved it one step, single sourcing another, reuse another, and true dynamic publishing moves it further still.

      Thus the author can no longer continue to work in a craft environment in which they can judge the correctness of their work by its immediate appearance. The final format of their content is now unknown and unknowable at the time of authoring and it is therefore essential that they work in an engineered authoring environment in which the judgement of correctness is done in engineering terms, not by visual inspection.

      1. Authors haven’t scribed the final form of their work since before the days of Gutenberg. What you’re essentially talking about is turning back the clock a bit to the days when writing, illustration, page layout, camera work, typesetting, etc., were done by different people. I certainly wouldn’t object if there was another warm body available to take the design and implementation of information delivery off writers’ hands so they can concentrate on the research, writing and verification of information. I just am not terribly confident that we will see all that much of it being signed off on by management that already is reluctant to spend money on technical writers.

        1. Gene, yes, since Gutenberg, which is why I listed the printing press as the first step away from final form being fixed at authoring time.

          I suppose there is a sense in which this is turning back the clock, in the sense that the author is no longer doing all those other steps. But in this case we are talking about them being done by algorithms, including algorithms that run at read time, not print time, so that is a pretty substantial difference.

          Lots of people are getting this sort of thing signed off by management, because they can show significant savings and significant quality improvements. But there is still a long way to go before everybody catches on.

  4. So is an information architect a sort of content engineer? And is a content engineer a sort of technical communicator (or is a technical communicator a sort of content enginner)? Hi ho

    I have always thought that the wording “content” feels kind of awkward. Content engineer becomes a kind of a paradox (or any other role including “content”). “Content” implies that your are dealing with “something” in a bucket and you do not really care about or know what it is, but it is the something in the bucket you are engineering, in contrast to “Information” that implies that the something in the bucket is what you care about. Information engineer? Hi ho

    1. Thanks for the comment, Jonatan.

      No, an information architect is not a sort of content engineer, though they should have some content engineering skills. But your question inspired a whole post to answer it: https://everypageispageone.com/2013/11/18/we-cant-use-in-tray-definitions-for-content-roles/.

      Personally, I am with you on “content”. I hate the word. It should have been “information”, but a bunch of bit jockeys beat us to it (though somehow the information architecture folks managed to claw back a piece of it). It might also have keen knowledge, but knowledge management also means something different. So Hi Ho, it is the word we are stuck with.

  5. Great post, Mark. Very clear (though I felt the previous one was clear enough too!) I think there comes a time to accept that a term, even if not perfect, is the one that’s widely used enough and descriptive enough to be the best one for the job. Like you, I feel that “Content Engineering” has reached that state.

    Jonatan, lots of people in this role are indeed called “information architect”, but it could invite confusion with the role of web information architect, which is primarily concerned with the organization of content on websites. Regarding your qualms about “content”, there has to be some word that’s broad enough for the range of media that we deal with. (“Information” doesn’t really cover entertainment content, for example.) And having such a word doesn’t necessarily imply disrespect or commoditization. Rachel Lovinger wrote a good piece on that here: http://scattergather.razorfish.com/1401/2013/10/29/the-trouble-with-content-part-1/

    1. Thanks for the comment, Joe.

      Agreed: at a certain point terminology sets hard and after that there is not much to be gained by trying to change it. For good or ill, “content engineering” and “content” are here to stay.

      And there is always something wrong with every choice of terminology. There are not enough words to go round, and every word you could possibly choose has an array of distracting connotations. I have long subscribed to the notion that words don’t have meanings. Words have denotation and connotation, but the sentence is the smallest unit of actual meaning.

  6. Mark, Your example in this post clarifies your point nicely. Separating content fron presentation does allow for content to be expressed in multiple ways, which might be valuable for both content editorial staff and audiences that prefer different styles or formats. You can take your engineering argument further by applying to your ideas on content behavior. For example, some audiences want interactive content while others don’t.

    1. Thanks for the comment, Michael.

      You raise an important point about user preferences. Users are increasingly free to consume content in the way that pleases them. This creates a challenge not only for content design, but for the content engineering necessary to provide all the choices that users might want.

  7. Writers should be vibrant and should be able to change style of writing as per requirement. This will not only make every articles or content interesting but also inspire you to do more innovative works than what you are doing now.

Leave a Reply

Your email address will not be published. Required fields are marked *