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.

8 Comments

  • August 17, 2007 - 1:50 am | Permalink

    Ahh but how do you punctuate bulleted lists?! ;-)

    Love this idea, may well adopt it for my team, anything that lets us focus on writing and not worry about “Rule 342: Acceptable usage of brackets” is a good thing.

  • Pingback: one man writes » Blog Archive » Recently read

  • Shannon
    August 17, 2007 - 7:57 am | Permalink

    To free yourself from the tyranny of your various English teachers and the pop-grammarians through the past 3 centuries, I recommend an excellent book by Joseph M. Williams called “Style”.

    Another excellent book, although much harder to find, is “Revising Prose” by Richard A. Lanham.

    When I was a pubs manager these two books were standard reference materials purchased for every writer who worked for me.

  • August 17, 2007 - 8:00 am | Permalink

    Ah, but the list itself serves an example of how bulleted lists are punctuated. :)

    Then again, I just checked our style guide for how to punctuate (or not) a bulleted list of single non-sentence items and we don’t address it at all that I can see.

    To be clear, this isn’t our full style guide, but I sure liked this summary. It certainly got me up and running quickly.

  • August 18, 2007 - 9:45 am | Permalink

    Yeah it’s a great summary, definitely “borrowing” this idea Anne.

    And I completely missed the ‘list as displayed’ angle, oops

  • diane fleming
    August 21, 2007 - 1:55 pm | Permalink

    I don’t get the one about punctuation outside quoted material – in American English, periods and commas appear inside the final quote…

    He said, “I think you are brilliant.”

    She quoted George Bush: “Let the doctors show their love.”

    But that’s probably not what you’re talking about!

    I love this idea – the simple style guide.

  • August 21, 2007 - 2:03 pm | Permalink

    Yes, that is what it’s talking about, and the punctuation rule has been the most difficult for me to become accustomed to. I don’t know the history behind that standard being established here at ASI. I’ll have to ask around.

    The punctuation outside quotes rule is standard British style, though. It certainly looks “incorrect” to my American-trained eye. :)

  • Pingback: Recently read | Gordon McLean

  • Leave a Reply