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:check enforcing 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:check to guard generated output and CSS references.
    • Added npm run tokens:update as 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.
    • 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.

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.html

Options

OptionRead by the shortcode template
topicRead by the shortcode template

Interface manifest

Kind
Shortcode
Category
Data
Status
Implemented
Implementation
Shortcode:layouts/shortcodes/brand-changelog.html