
Where to look if the Splunk Style Guide doesn't answer your question
The following resources provide information about industry standards in technical communication and writing best practices. Use these references secondarily to the Splunk Style Guide.
Style guides
The Splunk Style Guide covers issues specific to Splunk docs, but standards for grammar, spelling, and style are extensively covered in technical documentation references as well as general writing guides.
If you can't find what you're looking for in the Splunk Style Guide, refer to these reference materials:
Style issue | Resource |
---|---|
Technical documentation style issues | Google Developer Documentation Style Guide https://developers.google.com/style Microsoft Writing Style Guide |
Grammar and punctuation for nontechnical terms | The Chicago Manual of Style |
Spelling, definitions, and capitalization | Merriam-Webster Dictionary |
Writing references
The following references can enhance your writing and your understanding of best practices in technical communications:
Writing reference | Publication date | What's good about it |
---|---|---|
Every Page is Page One by Mark Baker and the Every Page is Page One website | 2013 | A resource with an accompanying blog, EPPO outlines the philosophy that the Splunk docs team subscribes to when architecting and developing information for Splunk customers. |
Developing Quality Technical Information, IBM Press | 2014 | Best practices for developing docs in regard to accuracy, clarity, completeness, concreteness, organization, retrievability, style, task orientation, and visual effectiveness. |
The Global English Style Guide: Writing Clear Translatable Documentation for a Global Market by John R. Kohl | 2008 | Guidelines for creating content that is ready for localization and translation. |
PREVIOUS Best practices for including videos |
This documentation applies to the following versions of Splunk® Style Guide: current
Feedback submitted, thanks!