RE: Long sentences

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

Nancy Allison wrote: 
 
> I'm working on a document that has a very good Introduction 
> -- except for one thing that I can't quite decide about. Some 
> of the sentences are awfully long. Would you break up or 
> reorganize these sentences? (I'm changing the topic in these 
> examples):
> 
> The Sunshine program spans all areas of personal homebuilding 
> efforts -- permit authorization through post-construction 
> inspection and reporting -- ensuring comprehensive, 
> documented compliance for any builder to all local and state 
> regulations.

The first one can -- and should, IMO -- easily be made into two
sentences: 

The Sunshine program spans all areas of personal homebuilding efforts --
permit authorization through post-construction inspection and reporting.
It ensures builders of comprehensive, documented compliance to all local
and state regulations.
 
> The Sunshine program delivers several immediate benefits, 
> including improved verification of a builder's construction 
> practices, reduced paperwork, streamlined communications, and 
> comprehensive review and alerts to avoid State-imposed fines.

This one cries out for a colon after "including," with the rest turned
into bullet items. Why do you thing that's inappropriate for an
introductory section? I think it's highly appropriate.

Richard


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




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

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output. http://www.DocToHelp.com/TechwrlList

Now shipping: Help & Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help & Manual: http://www.helpandmanual.com

---
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 admin -at- techwr-l -dot- com -dot-  Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.