Re: Long sentences
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.I think it is a flow problem. The example sentence seems long because the 'span' isn't completed. You have the word 'through' to anchor the end point of the span, but nothing to clearly designate the beginning. I would find it easier to read if you inserted the word 'from' at the beginning of the text that is set off with m-dashes. Otherwise, I don't think a perfunctory slice-and-dice operation is called for. Caveat: Your audience is the best judge on .
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.
The rule of thumb I use is to make a vertical list for three or more items. In tech writing, you might even call this a standard. But that's the great thing about standards--there are so many to choose from. Your embedded list is also standard, given a few considerations, such as not including any visually distracting glyphs (@#$%&), which your example doesn't use anyway. If you feel that a vertical list doesn't belong in this tract of text, then my advice is to go with that.
doc -at- edwordsmith -dot- com
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.
Long sentences: From: Nancy Allison
Search our Technical Writing Archives & Magazine