Saturday, February 06, 2010

Ignorance, the root and the stem of every evil

If you see that quote attributed to Plato, it's unsourced

I'm going to forego registering for yet another forum or getting into an incoherent, 140-characters-at-a-time attempt at dialog, and instead post my thoughts and questions here.

There's recently been talk that procedures don't really need stem sentences, and a claim that they were introduced into word processor document files due to the problems in restarting numbering of steps. Information Mapping is also blamed for the persistence of stem sentences to introduce procedures.

Here's what I'd like to know:

  • What's the earliest written text containing a stem sentence that can be found? When did they make their first appearance in written procedures with numbered steps (and when, for that matter, did numbered steps first show up)?

  • Can someone produce evidence of the stem sentence as a workaround for numbering problems in a word-processing application?

  • Who, if anyone, has studied the effect of stem sentences on readers? Have stem sentences been shown (not simply argued) to be of (no) benefit to readers?



Perhaps stems sentences make no difference. Perhaps they just started showing up, and then people kept using them because they seemed "right" somehow. Perhaps it would make no difference if we were to stop using them. But if technical communicators limit the discussion to rationalization and rhetoric, I think they're not really showing themselves to be the professionals they'd like to be seen as.

Friday, January 29, 2010

space between your ears - the final frontier?

This has gotten me thinking...

Advertising continues to take new forms and show up in new places. With other forms of content following suit, I wonder whether there will be negative reactions to it that advertising routinely gets.

Ad-free programming is already a feature on some commercial radio; will someone find a way to build "content-free" into something (and build a business model around it)?

What about the noise in your head? Perhaps someone will find a way to popularize training in "mind-clearing", meditation-type techniques. We value large physical spaces; perhaps we will start to value large mental spaces, too, and look for ways to create them, even if only for short periods of time.

In the meantime, though, you could do a lot worse than to look over Robert Bacal's stuff (see the link at the beginning of this post). It's got substance, but none of the fluff and cheerleading. Check it out...

Wednesday, January 27, 2010

From content to code to mechanical design

The reuse of information (or content), is inspired, I've heard, by the reuse of computer code. The idea of code reuse has been attributed to Douglas McIlroy. In 1968 McIlroy gave a talk titled "Mass Produced Software Components", which takes as its starting point the idea of mass production.

I'd be interested in reading anything about content reuse which traces its origins back to this and then works forward, looking at:

  • how mass production influenced code reuse (McIlory's talk sets out some ideas; which were implemented and how?).

  • whether problems of code reuse have analogues in the mass production world.

  • whether problems of content reuse have been noticed that have analogues in the worlds of code reuse and or mass production.

  • whether there's been subsequent influence of lean production methods on software development, and what (if anything) those engaged in content reuse might learn from lean methodology.



A lot of metaphor in all this, and not all of it is necessarily useful. But perhaps these questions may offer some cues as to how to better understand content reuse.

Follow the ideas

Doumont (2002) shares a term from Steven Pinker, "conventional absurdity":
a statement that goes against all common sense but that everyone believes becauase they dimly recall having heard it somewhere and because it is so pregnant with implications.


I imagine this sometimes happens in a way not unlike the children's game of "telephone". Someone reads an idea, uses it in an article or paper; someone picks it up, paraphrases it, passes it along, and so on. Before long, the idea has changed substantially.

That rule about non-verbal communication carrying most of the content of a message is another one that has often gotten muddled up (though word does seem to be getting around about that one).

It's for this reason that I like to see even practice-oriented articles, books, and presentations (not just academic ones) cite their sources. I want the opportunity to look at sources and see for myself whether the writer or the speaker has gotten the ideas right, and whether anything important has been left out.

It's not, however, only about checking the credibility of specific ideas. Consider also the idea of knowing the history of the profession you're in.

We're all familiar with arguments for being familiar with history, right? I found this paper (pdf) that presents them in an interesting way, putting them in the words of Herodotus:

  • In order to ensure that great deeds are not forgotten

  • In order to understand the present and prepare for the future

  • In order to understand the will of God

  • In order to provide a moral lesson—a model of good behavior and a warning about evil

  • In order to understand the history of one’s nation and to increase patriotism or sense of identity

  • In order to encourage civic participation and citizenship

  • In order to lessen prejudices

  • In order to appreciate arts and literature

  • In order to foster personal growth

  • In order to prepare for work by developing analytical skills



Depending on who you are and what you do, not all of these will apply -- but some may.

This page on the history of DITA introduced me to John Brockmann; as it turns out, Brockmann writes on the history of technical communication -- I found one them, From Millwrights to Shipwrights to the Twenty-First Century: Explorations in a History of Technical Communication in the United States. In the introduction, Brockmann gives the benefits of a historical perspective on technical communication:

  • It can reveal whether a contemporary standard in technical communication is enduring or transitory.

  • It can help answer questions about standards, education, and future directions for the professional.

  • It can, much like Barbara McClintock did for corn, help replenish the contemporary "gene pool" of technical communication by acquainting the practitioner with styles and techniques of the past that they can use to "recover qualities lost through generations of inbreeding" (yes, Brockmann said that in reference to corn).

  • It can provide familiarity with inadequacies of the past, which can help practitioners better judge styles and techniques used now and in future, and can help them repeating past mistakes.

  • It can help practitioners create a better sense of professional self-identity and tradition.



And that last point brings me to the notion of "disciplinarity". I was in the library the other day and by accident I came across Knowledges: historical and critical studies in disciplinarity. I'd very recently started thinking about "discipline" as a way to describe technical communication so the title must have caught my eye. I've started looking at it and a few things are resonating with me.

From the bit that I've read so far, disciplinarity appears to be concerned how disciplines:

  • describe themselves and their histories

  • establish boundaries between each other

  • produce knowledge

  • socialize members of their communities



It occurs to me that disciplinarity might be an interesting lens through which to watch some of the things going on around me, such as STC "telling its powerful story" and the rise of "content strategy". Not to explain them away (Keeping in mind what Shapin and Shaffer (1985) have to say about the dangers of posing awkward questions about "what everybody knows"), but rather to give me a way of looking at them without getting caught up, much as a writer would want to remain objective about their material and not lose sight of the need for effective words, structure, and so on.

Tuesday, January 26, 2010

that's entertainment (20100126)

Something with Google News (Canada) is not working right today; I grabbed these from this morning and this afternoon:

(Click image to enlarge.)

Made to Stick - trade?



I have this book. I'm done with it. I'd like to trade it for something interesting that is not another book.

If you've got a likely candidate, are in Toronto, and are interested in a trade, I can be reached at the name of this blog @gmail.com.

Young Gandalf does The Bard

or is it Magneto? Anyway...



...see this if you get the chance; I reckon that if you want to know what Kevin Smith means by "the Brits invented acting", this is as good a clue as any.

Monday, January 25, 2010

turning on comment moderation

Just had to delete a whole whack of comment spam (about 75 comments in total), so I'm turning on comment moderation.

Sunday, January 17, 2010

Slides are not all evil

Or should that be "all slides are not evil"?

Anyway, I was reading a recently published article on slides (as in the type you see at presentations, not in playgrounds). The article turned out to be rather disappointing, but it does point to a much better one (To see it, you either have to pay or be an STC member):

Doumont, Jean-Luc (2004). The Cognitive Style of PowerPoint: Slides Are Not All Evil. Technical Communication, Volume 52, Number 1, February 2005 , pp. 64-70(7)

Alternatively, here's a slightly blurry PDF scan of the article, apparently used in a course at MIT.

Enjoy...

Friday, January 15, 2010

the content "out there"

With apologies to Robert Pirsig:

You want to know how to write perfect content? It’s easy. Make yourself perfect and then just write naturally. That’s the way all the experts do it. The writing of content or the fixing of a motorcycle isn’t separate from the rest of your existence. If you’re a sloppy thinker the six days of the week you aren’t working on your content, what tools, what tips or tricks can make you all of a sudden sharp on the seventh? It all goes together.

The real content you’re working in is yourself. The content that appears to be “out there” and the person that appears to be “in here” are not two separate things. They grow toward Quality or fall away from Quality together.