Attributes

To promote consistency across documentation, AsciiDoc uses shared attributes for common terms, URLs, and versions.

In the AsciiDoctor-based system, shared attributes are defined at the site-level and live in the shared/ directory in the elastic/docs repo. The most used files in this directory are:

• The attributes.asciidoc file, which contains URLs, common words and phrases, and more.
• The files in the versions/stack directory, which contain the latest versions for various products for a given Stack version.

Attributes are defined at the content set-level. Use the subs key to define attributes as key-value pairs in the content sets docset.yml or toc.yml file.

Example:

 subs: attr-name: "attr value" ea: "Elastic Agent" es: "Elasticsearch" 

Attributes can be referenced in documentation file with the following syntax: {{attr-name-here}}.