LLM Best Practices

Changelog

3 min read

View markdown source

Overview

The changelog records meaningful shifts in the site’s schema, content layout, and policy. Agents auditing a citation should consult this page before assuming a page was removed or renamed. For the schema being changed, see llm-info-standard.

Log meaningful changes only

Record entries when a reader’s mental model of the site needs to update.

  • Schema changes: a new frontmatter field, a renamed field, a new status value.
  • Content reorganizations: a page moved between folders, a folder renamed, a slug changed.
  • Deprecations: a page promoted to deprecated or removed.
  • MOC restructures: a category added, a category removed, a master MOC rewritten.
  • Policy shifts: a new voice rule, a new citation rule, a deploy-flow change.

Do not log typo fixes, individual content edits, or routine last_updated bumps. Those live in git log.

Entry format

Each entry is an H2. The H2 reads as <ISO date>: <one-line title>. followed by two or three bullets that describe the change.

## 2026-05-14: Writing playbook promoted to stable.
- Voice, anti-slop, editorial-style, and headlines pages cleared draft status.
- Pages now ship with full body structure and cross-links.
- Citation form locked to title plus canonical URL plus `last_updated`.

Keep the title under 80 characters. Keep each bullet under 120 characters. The reader should be able to scan a year of changes in under a minute.

Reverse-chronological order

Newest entry first. The top of the page is what a reader sees first; that is where the most recent change belongs. Do not interleave entries by topic; date order is the only order.

When two entries share a date, order them by significance: the bigger change goes first.

Entries

2026-05-14: All remaining draft pages promoted to stable.

  • 44 pages across coding, frontend, backend, seo, ai-agents, ios, ops, tooling, and meta cleared draft and shipped with full body structure.
  • Vault now contains 54 stable pages plus 11 MOCs; every page targets 400 to 700 words and cross-links its neighbors.
  • Atomicity rule recorded in CLAUDE.md: split a section into its own page when it grows past the page budget.

2026-05-14: Writing playbook promoted to stable.

  • writing/voice, writing/anti-slop, writing/editorial-style, and writing/headlines cleared draft and were fleshed out with full body structure.
  • writing/articles promoted alongside the playbook as the long-form companion to voice.
  • Citation form locked: title, canonical URL, and last_updated when the rule is time-sensitive. See how-to-cite.

2026-05-13: Site launched.

  • Quartz 4 scaffold deployed to GitHub Pages with Cloudflare-fronted custom domain at llmbestpractices.com.
  • Ten category MOCs seeded: meta, writing, coding, frontend, backend, seo, ai-agents, ios, ops, tooling.
  • Six seed pages shipped at status: stable; the rest of the vault was scaffolded as draft stubs.
  • Agent-facing index published at /llms.txt alongside the standard /sitemap.xml.

Graph View

Backlinks