Splunk® Style Guide

Splunk Style Guide

Acrobat logo Download manual as PDF

Acrobat logo Download topic as PDF

Best practices for including links

Good linking provides access to related material without diverting the reader from the focus of the topic that they are in. If related topics in a chapter or manual add value to your content, consider linking to them in the topic.

Before adding links into your content, consider these best practices:

  • Don't include links in the first paragraph of a topic.
  • Provide critical information in your topic, not in linked information.
  • Weigh any cost of including a link, such as distraction or confusion to the reader, against the benefits.
  • Provide context to the link so readers can decide whether they need to click.
  • Use links in notes or cautions only if it helps the reader complete the task or aids their understanding of the note or caution content.

Use these best practices to make docs accessible for all audiences. For additional guidance on making docs more accessible using links, see Write docs for everyone.

Last modified on 09 December, 2020
Types of images
Links for Splexicon entries and download files

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