Tips for Stronger Writing

[Paul W. Frields]

On Wed, 2008-10-22 at 14:38 -0700, Karsten 'quaid' Wade wrote:
> On Wed, 2008-10-22 at 11:09 -0400, Elizabeth Ann West wrote:
> > Hello All,
> > 
> > As I am working on editing the install-guide, I had a great idea for a
> > series through the docs-list. If people are interested, I would be happy
> > to start condensing my editing techniques into small tidbits
> > documentation writers can learn from and apply to any writing pieces,
> > making them stronger. I can try to have a new Tips for Stronger Writing
> > each week, if you all find them helpful. Here is the first one titled
> > "Trim the That." Please let me know how you like it, if it is easy to
> > understand, and if you would like me to continue the series.
> 
> +10
> 
> Also, catch me on IRC and let's figure out a good place to put these on
> the wiki.  I'm thinking we want to mutate the style guide a bit, adding
> a new [[Category:Style guide]] so we can add content easily without
> worrying about structure too much.

Very nice.  Some other suggestions:

* use of "will" (i.e. future tense to indicate how software reacts to
user interaction)
* use of "simply"/"just" (to indicate ease)
* use of "which" vs. "that"

-- 
Paul W. Frields
  gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233  5906 ACDB C937 BD11 3717
  http://paul.frields.org/   -  -   http://pfrields.fedorapeople.org/
  irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <http://listman.redhat.com/archives/fedora-docs-list/attachments/20081022/8191ca4f/attachment.sig>