If content is to be used in multiple locations throughout the documentation, it may be beneficial to convert the content to either of the following:

• A snippet - suitable for a section of text or code block that needs to appear in more than one location.
• A site variable - suitable for a small amount of information, for example a version number or single word.

Snippets can be saved as .md, .adoc, .html, and should be located within jekyll/_includes/snippets.

To include a snippet within a page, use the following syntax:

{% include snippets/<my-snippet>.adoc %}

Site variables are defined within jekyll/_config.yml as key value pairs:

my-variable-name: my-variable-value

To use the variable within a docs page, use the following syntax:

{{site.<my_variable_name>}}