« Frogs and Toads! Oh My | Main | New Look! »

Grammar Notes for Technical Documentation Writers

  1. Propositions are bad things to end sentences with.
  2. Assignage is the act of assigning to something. If you just add "-age" to a word, its meanage might not coincide with your thinkage.
  3. Any amount is considerable.
  4. The word amount applies to continuous things like water. You have a large amount of water. You have a number of discrete records.
  5. If your sentence sounds awkward, it is. Rewrite it.
  6. "This means that" is extraneous. This means that you can remove it.
  7. "And" is much simpler than "as well as", as well as being easier to read.
  8. Section Headings: Section headings need not be repeated in the first sentence of a section.
  9. "Exist" does not exist to be used in every existing sentence, even ones that have not been written. Not all existing persons reading the existing documentation need to be reminded of their existence.

Comments (3)

matt:

what if I think it's a non-existing document, and need to be reminded?


You forgot about the verbification of nouns. You can take perfectly innocent nouns and verbify them. See previous sentence. :)

Drew:

Grammar notes from the future (July 9th)! Have you seen anything else of the future?

About

This page contains a single entry from the blog posted on July 9, 2004 4:48 PM.

The previous post in this blog was Frogs and Toads! Oh My.

The next post in this blog is New Look!.

Many more can be found on the main index page or by looking through the archives.

Powered by
Movable Type 3.33