Brand-changelog
Preview#
Changelog
Most recent check of all entries: August 17, 2026
- Generated token reference data and category pages from token metadata, with
npm run tokens:checkenforcing data drift. - Accepted ADR 0005: token category documentation must be generated from token metadata or Style Dictionary output, not maintained as manual tables.
- Expanded Foundations > Tokens into a small section with Introduction, Types of tokens, Naming, Pipeline, and Generated categories.
- Activated generated token CSS in the Hugo stylesheet bundle and added
npm run tokens:checkto guard generated output and CSS references. - Added
npm run tokens:updateas the safe token workflow: rebuild generated CSS, then verify it. - Documented the brand changelog component and its recommended candidate pages after verifying it on token and quality-check pages.
- Moved the brand glossary to
data/brand/glossary.yml, added type filtering, and nested Glossary under Overview in the documentation sidebar. - Shared the glossary table renderer across the brand and main website glossaries while keeping separate data sources and title blocks.
- Generated token reference data and category pages from token metadata, with
- Added the dormant Style Dictionary pipeline: source tokens, generated CSS output, and
npm run tokens:build. - Accepted ADR 0004: use the current stable dependency version by default and treat warnings as work.
- Added Site implementation > Quality checks as the technical home for source checks, Hugo checks, generated-output checks, runtime checks, and manual passes.
- Accepted ADR 0001 and split the brand documentation into Identity, Foundations, Site governance, and Site implementation.
- Added the dormant Style Dictionary pipeline: source tokens, generated CSS output, and
Example
{{< brand-changelog topic="tokens" >}}When to use
A filtered changelog for the brand system, rendered from `data/brand/changelog.yml`.
Implementation
layouts/shortcodes/brand-changelog.htmlOptions
| Option | Read by the shortcode template |
|---|---|
topic | Read by the shortcode template |
Interface manifest
- Kind
- Shortcode
- Category
- Data
- Status
- Implemented
- Implementation
- Shortcode:
layouts/shortcodes/brand-changelog.html