Content Strategy
Writing
Reference: Style Guides
17 min
a style guide serves as a set of standardized rules and guidelines that define the formatting, language and tone of technical documents a style guide also means that writers have more time to think about what they say instead of how they say it once you internalize the standards of a style guide and you don't have to choose your words, writing becomes much faster! style guides designed for technical writing the following list includes some of the most popular english language guides that are written specifically for technical documentation microsoft manual of style the microsoft style guide covers a broad range of topics, including grammar, terminology, formatting and style preferences for digital content it is mostly used in the software industry, particularly for products that run on microsoft windows microsoft manual of style (online, free) be aware that there is some controversy in the community! the online version is an abbreviated form of the previous, printed guide, and some writers feel it's lacking in content as a result you may still be able to buy used copies of the last printed edition , the 4th edition google developer documentation style guide google’s style guide covers the usual technical writing topics, such as content structure, terminology and how to write for an international audience it is more concise than other guides and focuses on short explanations and examples google style guide (online, free) apple style guide apple’s style guide covers the tone and voice of apple's product documentation, focusing on clarity and precision the guide also includes information for developers working on user interfaces for apple devices apple style guide (online, free) red hat style guide red hat’s style guide is aimed at open source software documentation, providing detailed instructions on formatting, writing conventions and technical terminology red hat style guide (online, free) ibm style guide ibm’s style guide is used especially for large scale technical documentation it offers detailed guidance on terminology, tone and writing conventions ibm style guide (online or paperback, paid) asd ste100 asd ste100 is not a style guide per se, but it is a controlled language standard that serves the same purpose ste stands for simplified technical english and the standard was developed by the aerospace and defence industries association of europe (asd) it is mostly used in aerospace, defense, military, manufacturing and engineering asd ste100 standards (link to form to request the standard documentation, free) ieee editorial style manual this style guide was developed by the institute of electrical and electronics engineers (ieee) and is primarily used for academic papers, research articles and technical documentation in engineering ieee editorial style manual (online, free) asme style guide the asme style guide is developed by the american society of mechanical engineers (asme) and provides guidelines for writing and formatting technical papers, journal articles, and engineering reports asme journal information for authors (online, free) asme author guidelines for proceedings (online, free) for more details and examples of popular style guides, you can also read this archbee blog post style guides from other industries chicago manual of style (cmos) while it’s a general purpose style guide, cmos is often used by technical writers it is extremely detailed and covers most usage of the english language chicago manual of style (printed or online, paid) oxford style manual this style guide is written for writers and editors in all domains and it’s often referenced by technical writers for its grammar and punctuation rules it also includes a dictionary oxford style manual (printed, paid) associated press (ap) stylebook while the ap stylebook is traditionally used in journalism, it is also widely adopted in technical writing, particularly for web content it’s a common choice for technical writing aimed at a broad audience ap stylebook (printed or e book, paid)
🤔
Have a question?
Our super-smart AI,knowledgeable support team and an awesome community will get you an answer in a flash.
To ask a question or participate in discussions, you'll need to authenticate first.