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 https //learn microsoft com/en us/style guide/welcome/ 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 https //www amazon com/microsoft manual style 4th corporation/dp/0735648719 , 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 https //developers google com/style 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 https //support apple com/guide/applestyleguide/welcome/web 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 https //stylepedia net/style/ 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 https //www oreilly com/library/view/ibm style guide/9780132118989/ 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 https //www asd ste100 org/ste downloads html 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 https //docs google com/document/d/1oalfyqvfxkkmelf79u3b93sjmieitnjc12wpjrkesdm/edit?tab=t 0 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 https //www asme org/publications submissions/journals/information for authors/journal guidelines https //www asme org/publications submissions/proceedings/author guidelines for more details and examples of popular style guides, you can also read https //www archbee com/blog/technical writing style guide 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 https //www chicagomanualofstyle org/home html 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 https //global oup com/academic/product/new oxford style manual 9780198767251 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 https //www apstylebook com/
🤔
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.