Welcome to Anne Gentle's just write click blog

RSS Subscribe to RSS

Simplest of style guides

Ah, simplicity. Elegant. Succinct. Basic. Good.

Welcome to ASI, new writer. Here are the basics:

  • Write well, quickly, in the active voice and the present tense.

  • Put punctuation outside the quoted material.

  • Maintain gender neutrality. (”He” and “she”: bad. “They”: good.)

  • Replace semicolons with periods.

  • Use numerals for all numbers.

  • Make cross-references target-neutral.

  • Insert AIT variables.

  • Publish Word documents or HTML files only.

  • If it’s not here, look to The Microsoft Manual of Style for Technical Publications.


Posted on : Aug 16 2007
Tags: , , , , , ,
Posted under writing |