Chapter 1. Mechanics of Writing

Error-free writing requires more than just using good grammar. You must also use correct mechanics of writing in your documents. The mechanics of writing specifies the established conventions for words used in technical documentation. Grammar reflects the forms of words and their relationships within a sentence. For instance, if you put an apostrophe in a plural word (“Create two file’s”), you have made a mistake in the mechanics of writing, not grammar.

The mechanics of writing guidelines in this chapter work well for computer documentation, but other style guides might suggest different rules that are equally effective. In most cases which rules you follow doesn’t matter as long as you are consistent ...

Get Read Me First! A Style Guide for the Computer Industry, Third Edition now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.