Splunk® Style Guide

Splunk Style Guide

Acrobat logo Download manual as PDF

Acrobat logo Download topic as PDF


Make the point in each of your sentences without using parentheses. Don't use parentheses in place of commas, to enclose a complete sentence, or to include unnecessary information or an afterthought.

You can use parentheses to introduce an abbreviation.

Use the Splunk Search Processing Language (SPL) to search your data.
Use SPL (the Splunk Search Processing Language) to search your data.

You can use parentheses when explaining that a step is optional in a task.

(Optional) Provide the context for the task in a new paragraph.
Optional: Provide the context for the task in a new paragraph.
Provide the context for the task in a new paragraph (optional).

You can also use parentheses when writing about one or more fields in statistical commands and charting functions for SPL. See the following example:

  • Use with earliest(x) and latest(x) to calculate the rate of increase.

Don't write a lowercase "s" or "es" in parentheses, "(s)" or "(es)", after a noun to indicate both singular and plural. Choose the best option for your documentation.

Last modified on 25 May, 2022
Exclamation points

This documentation applies to the following versions of Splunk® Style Guide: current

Was this documentation topic helpful?

You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters