RE: follow the following

["Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>]

Rob Domaschuk wrote: 
 
> I, like Eric, have also missed most of this thread, so the 
> same apology/caveat applies. Here's what I write:
> 
> To _____________, complete the following steps:  
> 
> I insert that action in the line; "To add a new contact name, 
> complete the following steps", or "To insert a graphic frame, 
> complete the following steps:" 

FWIW, I think this has a nicer ring to it than "perform the following,"
"follow the following," "follow these steps," etc. 

But I'm with Geoff Hart: "When in doubt, cut it out." Honestly now, what
value do the words after the comma add? Is your audience so unfamiliar
with the concept of procedures that they won't understand the purpose of
the numbered paragraphs that follow? 

Pick one of these two options and use it consistently:

Option A -- heading plus lead-in subordinate clause:

	Adding a Widget

	To add a widget:
	1. Do something.
	2. Do something else. 
	...

Option B -- heading only 

	Adding a Widget

	1. Do something.
	2. Do something else. 
	...

"It's my opinion and it's very true." 

Richard


------
Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
303-223-5111
------
rgcombs AT gmailDOTcom
303-777-0436
------




^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today!. http://www.webworks.com/techwr-l

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy.  Watch the demo at http://www.DocToHelp.com/TechwrlList

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -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%40infoinfocus.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to lisa -at- techwr-l -dot- com -dot-  Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.