Microsoft Writing Style Guide Released
This post was written by Palle Petersen, Senior Program Manager working in Microsoft's Global Readiness team.
Today, we're happy to announce that we’ve launched the Microsoft Writing Style Guide!
The goal of the Microsoft Writing Style Guide is to help editors, technical writers, developers, marketers, and anyone else in IT write better content.
Since 1995, Microsoft has provided writing guidelines to editors and developers. The new Microsoft Writing Style Guide brings the guidance up-to-date for 2018 and is an evolution of the Microsoft Manual of Style from 2012. The principles and guidelines in the guide are the same as those used by internal Microsoft writers, which allows consistent quality and style across all apps and content.
In the guide, you'll find:
- An overview of the Microsoft brand voice principles: warm and relaxed, crisp and clear, and ready to lend a hand.
- A 300-plus topic word list that clarifies the correct spelling and usage of industry terms like platform as a service, cybersecurity, and chatbot, or capitalization issues (Machine Learning vs. machine learning).
- Collections of terms from specific domains, for example the cloud computing term list and the bot term list.
- For developers: tips on how to write code examples and reference documentation, and how to format text elements.
- Guidelines for ensuring that content is accessible, adapted for localization, bias-free, and works on multiple devices.
We'd love to hear your thoughts. Choose the type you'd like to provide:
Our feedback system is built on GitHub Issues. Read more on our blog.