Harry Miller's Technical Writing Blog

Mostly podcasts about documentation, technical writing, and technical editing.

The IM Model of Tech Writing

Thoughts about highly-targeted information delivery.

Download this episode
Duration 2:14
Size 2.0 MB

Published Monday, July 16, 2007 9:18 PM by HarryMiller

Attachment(s): http://media.libsyn.com/media/harrymiller/HM_IMModel.mp3

Comment Notification

If you would like to receive an email when updates are made to this post, please register here

Subscribe to this post's comments using RSS

Comments

 

JohnDiddler said:

woo hoo ROCK STAR HARRY MILLER DANCING A JIG!

i'm at amazon for the summer, and they've juked me into writing sample code, Harry. it's so wrong!

WANT ME SOME WRITING TASKZ!!!

i used to tell my brother he'd be a better writer if each word cost a nickel. he never got the hint, though.

July 18, 2007 12:25 PM
 

Judy Horton said:

Isn't DITA a methodology that allows you to, essentially, create those little "Instant Messaging" types of content so that it could quickly be pulled out in a search.

July 19, 2007 3:18 PM
 

Harry Miller said:

I don't use DITA, but I use something very similar--we have small, self-contained topics that can each contain only one type of information, such as a task or a conceptual explanation. But inside those very structured, schema-bound containers, writers are free to organize their sentences and logic however they like. Often they'll start off with a few sentences of background information that is not really essential to know to be able to do the task, and the point comes at the end of the paragraph. By that time, our IM reader has switched windows as is poking buttons or reading e-mail. :-) So I still need to find the real Instant Message at the end of the paragraph (or even later), and move it right up to the top, and then either delete the non-essential information or move it somewhere more appropriate.

July 19, 2007 3:42 PM

Leave a Comment

(required) 
(optional)
(required) 
Submit

This Blog

Syndication

Tags

No tags have been created or used yet.

News

All postings are provided "AS IS" with no warranties, and confer no rights. This site contains my personal opinions. These opinions do not represent my employer's view in any way. Also, I'll probably change my mind at some point.

© 2008 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Microsoft
Page view tracker