This is the full list of specialized terms used in this product documentation. They are also generated as JSON at /data/terms.json so we can highlight them in the text when we get to it. This is just to show the power of storing data in flat files reusable throughout product docs.

artifact

A digital package (file or archive) representing a discrete component of a product. Here we use artifact to describe a descrete instance of output, such as a single HTML or PDF file, or a Jekyll website or Deck.js slide presentation.

AsciiDoc

Dynamic, lightweight markup language for developing rich, complex documentation projects in flat files. (Resource)

Asciidoctor

Suite of open source tools used to process AsciiDoc markup into various rendered output formats. (Resource)

build

The (usually automated) series of actions necessary to compile and package software or documentation.

Liquid

Open source templating markup language maintained by Shopify (Resource)

YAML

a slightly dynamic, semi-structured data format for nested data (Resource)

How this glossary was sourced

The contents of this appendix were drawn from a semi-structured “small data” file (_data/terms.yml), which looks a little something like this:

terms.yml
- term: Asciidoctor
  def: Suite of open source tools used to process AsciiDoc markup into various rendered output formats.
  ref: http://asciidoctor.org
- term: build
  def: The (usually automated) series of actions necessary to compile and package software or documentation.
  aliases: [build procedure]
- term: Liquid
  def: Open source templating markup language maintained by Shopify
  ref: https://help.shopify.com/themes/liquid

This data is combined with the template at _templates/liquid/terms.asciidoc to build an AsciiDoc formatted file (build/includes/built/terms.adoc).

GETTING META!
You wanna know what’s really friggin cool? The example YAML snippet above is drawn directly from the actual file at build time. That means the above will always display the exact, actual content of the YAML it is referencing.