When everything is vague

By Anonymous -
"Without interacting with the user, you can’t learn the user’s vocabulary and the tasks they need to perform. Without a knowledge of user vocabulary and tasks, your help material is destined to be unhelpful. Without helpful user assistance, your role on the project team and your own sense of importance on the project diminish."

I have pasted these words from Tom Johsnon's excellent post on the various level of harassment and stumbling blocks encountered by the hapless technical writers. Another method of ostacrization is "the domain is so vast" or "the functionality is too complex" comments. This is equivalent to telling you that I am not share my knowledge that easily with you.

Comments

Post a Comment

Popular posts from this blog

Types of Headlines- a bit old fashioned

By Anonymous -
The following classification of newspaper headlines is based on my journalism notes. They are from the point of page layout. Flush Left -Headlines that are aligned to the left margin of the page. Step -A headline of two or three lines with the top one flushed to the left and the last one to the right. Inverted Pyramid -Headline arranged in the form of an inverted pyramid. Hanging Indention -Headline flushed to the right of the page, except the first line. Kicker -Headline of two parts with one line in a smaller font size and in a different type family than the others. Overline -Headline with a smaller supporting line aligned to the middle at the top. Underline - Kicker in reverse. Hammer -A kicker reversely arranged.Usually a Hammer has two or three words with bigger headline at the top. Combination -A headline that combines any of the above types. New Pattern -Headlines that combine new patterns and artwork.
Read more