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
Attachment:
signature.asc
Description: This is a digitally signed message part
-- fedora-docs-list mailing list fedora-docs-list@xxxxxxxxxx To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-docs-list
