Microsoft Manual of Style 4th edition, essentially the English Style Guide for Microsoft products – has now been released and is available in ebook versions (PDF, ePub, Mobi/Kindle) and a hard copy.
“It’s designed to help communicate clearly, consistently, and accurately about technical topics. It’s aimed at content creators, journalists, technical writers, editors, and everyone else who writes about computer technology. It also features a comprehensive glossary of both general technology terms and those specific to Microsoft as well as usage and style guidelines and guidance on grammar, tone, and voice,” Microsoft states.
This Microsoft Press edition includes the new guidance on voice, web content, global content, NUI, and other guidelines for creating content in English. Here’re a few content examples:
Guidance on writing for machine-translated content:
For machine-translated content, do not embed error message text that forms a completed sentence inside the sentence that makes a statement about the error message. Instead, structure the sentence so that the error message text is set off on a separate line or rewrite the sentence so that the error message text becomes a grammatical part of the sentence in which it’s embedded.
For example, consider the following sentence:
If you receive a “There is no CD disc” in the drive message, insert a new CD disc in the drive and try again.
To make this sentence better for machine translation, restructure this sentence as follows:
If you receive the following message, insert a new CD disc in the drive and try again: “There is no CD disc in the drive.”
- O’Reilly is offering print and various electronic versions, as well as a free download of the “Content for the web” and “The user interface” chapters here.
- Microsoft Press includes the “Content for a worldwide audience” chapter in their announcement on the Microsoft Press blog.
- Amazon is offering a 45% discount and should provide a Kindle edition soon.