Writing conventions

[Ellen Vanrenen <ellen -dot- vanrenen -at- clear-technology -dot- com>]

Thanks to everyone on the advice about Word and Frame tables and Word
conversion.

My next question is this:

The following paragraph has been inserted into our style guide, which is not
yet finalized:

				Keep your words, sentences and sections
short. The rule of thumb is 7 items per section. Anything longer is harder
for the reader to absorb. If your document runs much longer, consider
dividing it into logical segments

Aside from my not know what "section" signifies in the paragraph provided, I
am wondering if  this is a general standard for documentation? I tend to
think having a lot of headings with short paragraphs would force you to
simplify, but perhaps it would help one to write more concisely. I tend to
write complex material in more complex sentence structures than this
guideline would allow.

Am I incorrect? Should I revise my writing style?



Ellen Vanrenen
Technical Writer
Clear Technology, Inc.
303-583-4170 (direct line)
ellen -dot- vanrenen -at- clear-technology -dot- com

____________________________________________________________________________
WARNING - THIS E-MAIL TRANSMISSION IS CONFIDENTIAL. This e-mail transmission
(including any accompanying attachments) contains confidential information
which is intended for the named addressee only. If you are not the intended
recipient, you are hereby notified that any use, dissemination, distribution
or reproduction of this e-mail is prohibited. If you have received this
e-mail in error please contact me immediately. Thank you.
____________________________________________________________________________


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

Planning to attend IPCC 01, October 24-27 in Santa Fe?  Sign up by
October 3 and get a substantial discount!  Program information, 
online registration, and more on http://ieeepcs.org/2001/

+++  Miramo -- Database/XML publishing automation.  See us at  +++
  +++  Seybold SFO, Sept. 25-27, in the Adobe Partners Pavilion  +++
  +++ More info: http://www.axialinfo.com  http://www.miramo.com +++

---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot-  Visit 
http://www.raycomm.com/techwhirl/ for more resources and info.