Quill and Parchment
A writer's workshop for all genres. Got a case
of writer's block? Here's the place to rev up
your RP, perfect your poetry, fine tune your
fiction, crank up your commentary...and, well
you get the idea.
Board:
Genre: Technical
Thread:
Moans and Manuals
Technical writers frequently produce structured documentation. Have a tip, technique, or trouble with a document? How do you decide the best structure, layout, and design of your document? How does that structure change when (and if) it is published to the Web, print, online help, or other media? ...
more
NEXT:
Message:
Feature versus user manual writing
Author: * Ceffyl Aedui -
3
Posts
Date: Apr 9, 2004 - 20:17
I did some more thinking about feature article versus technical writing experiences. In technical writing, especially user manuals and online help, you're leading the reader thruogh a series of exercises which cover action/result statements. No opionions are expressed. The author's voice isn't very pronounced.
In a feature article, you'll taking the reader by the hand and leading him/her not from action to result, but from ideas to conclusions.
Techniacl writing documents an existing problem, and, in stuff I do in general, doesn't provide a conclusion (unless you include 'that's the way the thing works').
Has this been any one else's experience?
NEXT:
PREV:
Hearing voices ... - (
* Ceffyl Aedui, - posted: Feb 22, 2004 - 04:52 )