Style guides for software documentation
TechScribe recommends these style guides:
- Read Me First! A Style Guide for the Computer Industry. Sun Technical Publications, 2003. ISBN 0-13-142899-3. Read Me First! is the best practical style guide that we know about.
- Microsoft Writing Style Guide (https://learn.microsoft.com/en-gb/style-guide/welcome/). (The Microsoft Writing Style Guide replaces the Microsoft Manual of Style.)
- Apple Style Guide, 2017, explains the style and the use of Apple terms (https://help.apple.com/asg/mac/2013/).
General style guides
Other excellent style guides are available, but they are for professional technical writers. We think that the style guides in the list above are the most suitable for people who are not professional technical writers, but who write software documentation as part of their work.
For excellent general advice, see:
- The Oxford Manual of Style
- The Chicago Manual of Style
- The Elements of Style, William Strunk (free to view, www.bartleby.com/141/)
See also
Style guide for software developers
Publicly available IT standards (free download, https://standards.iso.org/ittf/PubliclyAvailableStandards/index.html)