Re: introducing steps
adding "follow these steps" seems like unnecessary verbiage.
Seen in a document once, on Mars or somewhere. Ask your teacher about it:
"This document consists of material that has been carefully researched by professional writers. Please read it carefully before using the product."
The writer of that stuff only dipped into the well. Here's what could have followed:
"The pages of this technical document are filled with paragraphs. As specified in Strunk and White Rule 13, each paragraph is constructed of sentences and each sentence is in turn constructed of words. These words have been chosen with great care in order to pass on to the reader the knowledge that is necessary to understand the usage of the equipment and computer programs described herein. Complete reading and full comprehension of this material, while not mandatory, is highly recommended."
If the writing is to contain information about the writing, you could suggest also that the teacher tell you how to write colophons. Here Janice Gelb was again on target, quoting Tom Weller in this reference:
http://www.techwr-l.com/archives/0901/techwhirl-0901-00529.html
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com
To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com
Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.
Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
References:
introducing steps: From: Becca
Previous by Author:
Re: STC certification program
Next by Author:
Re: replacing text with visuals (was: introducing steps - translation issues)
Previous by Thread:
RE: introducing steps
Next by Thread:
RE: introducing steps
Search our Technical Writing Archives & Magazine
Visit TechWhirl's Other Sites
Sponsored Ads