Comma
Although there are many rules for when to use a comma, the following table shows the most common uses in Splunk documentation. For commas in numbers, see Commas and decimals.
Scenario | Example |
---|---|
To separate a list of 3 or more words or word groups. This type of comma is known as the serial, or Oxford, comma. | Generate reports, views, and dashboards. |
To separate adjectives when they each modify the noun independently. | The feature groups the extracted fields into a single, ordered sequence. |
To offset appositives from the rest of the sentence. | Use wiki markup when you don't have any elements, such as code or a table, following a step. |
After a prepositional phrase. | After reviewing the document, I had a chance to compile a list of reading material. |
Don't use commas to separate 2 verb phrases that modify the same subject. See the following example:
Do this | Don't do this |
---|---|
I collected the various pieces of documentation and forwarded them to the appropriate parties. | I collected the various pieces of documentation, and forwarded them to the appropriate parties. |
Colon | Dashes |
This documentation applies to the following versions of Splunk® Style Guide: current
Feedback submitted, thanks!