Random thoughts about publishing

icon Site Feed

Labels

Palimpsest has moved. Please visit our blog in its new location for the most recent posts from Scriptorium.

Palimpsest

 

Food for thought on document maintenance

Friday, November 14, 2008 — posted by Sarah O'Keefe

[Updated to add link that I rudely left out.]

In a report from tekom (link in German), we hear about a session on translation reuse strategies.

The presenters point out one underappreciated risk of translation management -- language evolution. They note that as languages evolve, information stored in translation memory could become out-of-date. In particular, they noted that Polish has changed significantly in the past few years. (translation and paraphrase mine)

And today, there's an interesting article at Gryphon Mountain Journals. Ben Minson points out the conflict between writing content that is easy to maintain and content that is most helpful to the reader:

Generic: “To turn on the machine, press the Power button.”

Specific: “To turn on the machine, press the Power button, which is located on the top of the device.” (…plus an image of the button, plus an image pointing out where on the machine it appears.)

Which one is easier to maintain? Which one is more helpful?

I’ll ask a different way. Which one is better for the writer, and which one is better for the audience?

We need to learn to strike a balance between efficiency and usability. That said, most of the authoring environments I see have a long way to go before they reach "overly efficient" and need to swing back toward usability.

Labels: , ,


8:30 AM Permalink | |

<< Home

divider


Scriptorium Publishing | Post Office Box 12761 Research Triangle Park, NC 27709 | (919) 481 2701 | info@scriptorium.com