Example names and domains
If you need to create a fictitious name, email address, domain name, phone number, or IP address in your docs, create an example that adheres to the following guidance.
If you need a fictitious name for an example in your docs, use a name that's sensitive to culture, religious affiliation, holidays, traditions, politics, and business. Make sure that the name you create reflects the wide range of names used around the world.
Don't use a fictional character that's currently in copyright, your own name, or the name of friends or family members as an example name.
See the following examples of names that meet this guidance:
- Alex Martin
- Claudia Garcia
- Celestino Paulo
- David Mayer
- Ikraam Rahat
- Maria Dubois
- Nyah Aamadu
- Rutherford Sullivan
- Vanya Patel
- Wei Zhang
If you need a fictitious email address for an example in your docs, use a name that follows the guidance in the Names section. Never use your own name, or the name of friends or family members, in an example email address.
Use Buttercup Games, a fictitious online store created by Splunk, as the email domain.
See the following examples:
In cases where it doesn't make sense to use Buttercup Games as the email domain, use the @example.com suffix.
If you need a fictitious domain name for an example in your docs, use a URL from the domain example.com, such as http://www.example.splunk.com.
In cases where it doesn't make sense to use Splunk in the URL, you can use http://www.example.com. The Internet Assigned Numbers Authority (IANA) set aside this domain specifically for documentation needs.
If you need a fictitious phone number for an example in your docs, use a North American phone number in the range +1-555-555-0100 through +1-555-555-0199. The North American Numbering Plan set aside this range of phone numbers to use in examples and in fiction.
If you need a fictitious international phone number for an example in your docs, you can use the fictitious Australian phone number of +61-02-5550-9988.
Never use a real phone number as a phone number example.
If you need a fictitious IPv6 address for an example in your docs, use an IP address in the following range:
If you need a fictitious IPv4 address for an example in your docs, use an IP address in one of the following ranges:
- 192.0.2.0 to 192.0.2.255
- 198.51.100.0 to 198.51.100.255
- 203.0.113.0 to 203.0.113.255
The Internet Engineering Task Force (IETF) set aside these blocks of addresses specifically for documentation needs.
Plurals in parentheses
This documentation applies to the following versions of Splunk® Style Guide: current, current