How Can We Help?
To create a technical document, a technical writer must understand the audience and purpose. The writer gathers information by studying existing material and interviewing SMEs. The technical writer also studies the audience to learn their needs and technical understanding level.
Well-formed technical documents follow common publishing guidelines. Technical documentation comes in many styles and formats, depending on the medium. Printed and online documentation differ in necessary ways but adhere to largely identical guidelines for prose, information structure, and layout. Usually, technical writers follow formatting conventions described in a standard style guide.
In the US, technical writers typically use the Chicago Manual of Style (CMS). Many companies have internal corporate style guides that cover specific corporate issues such as logo use, branding, and other aspects of corporate style.
The Microsoft Style Guide is typically used for software user documentation. However, there are others that may be referenced to style your user documentation, such as the Google Developer Guide and the Gnome Style Guide.
