Skip to content

v1 audit fixes: dead tokens, stale docs tables, blog corrections#49

Merged
minimaldesign merged 7 commits into
mainfrom
v1-audit-fixes
Jul 24, 2026
Merged

v1 audit fixes: dead tokens, stale docs tables, blog corrections#49
minimaldesign merged 7 commits into
mainfrom
v1-audit-fixes

Conversation

@minimaldesign

Copy link
Copy Markdown
Owner

Final pre-tag audit fixes for v1.0. Everything from the audit is addressed except the display-tracking TODO in settings.tokens.css, which stays by request.

CSS bugs (same class as the recently deleted tokens)

  • Removed the orphan --meter-color token from elements.form.css: nothing ever consumed it (the meter paints with --meter-color-track/low/med/high). Recorded in the changelog next to the --layout-aside-background-color removal. dist/ regenerated by the pre-commit hook.
  • Removed the dead radius-demo rule in page.docs.css that referenced the nonexistent --radius-drawn token (the tokens page table has 6 rows; the CSS styled a 7th).

Docs

  • tokens: the heading-sizes table was wrong on every row (one step smaller than the actual clamps); now matches the source (heading-1 is display-md → display-xl, etc.). Documented the new --highlight-500 token with a demo swatch and its relationship to --marker-color. Renamed the font-stack row monospace to the real token name mono. Fixed the confusing font-stack notice ("wether", two things called "the system default").
  • media-queries: documented the entire user-preference and device-capability set (--OSdark/--OSlight, --motionOK, --touch/--mouse/--stylus/--pointer, --forcedColors, --HDcolor, etc.), fixed the mangled (width <section 768px) table cell, and noted that -phone variants stop at lg.
  • start: the states example now follows the block_element syntax it sits under (form_input/form_submit instead of formInput/formSubmit), the postcss-preset-env mention now links to preset-env instead of postcss-mixins, and two typos are fixed (Targeting, properties).
  • components/start: the zero-JavaScript claim now lists the real exceptions (header menu, banner, hero slideshow, TOC scrollspy, read progress bar fallback), and the intro no longer promises a table title the pages don't use.
  • featuregrid: documented FeatureItem's titleClass/iconClass props (matching how section documents its equivalents).
  • lastUpdate bumped on every page whose content changed; tokens and media-queries also bumped to version 1 since they now reflect the v1 framework.

Blog

  • structure post: the layer list contradicted its own 2026 update note; the removed Pages layer is gone and the Theme layer is in.
  • 1.0 post + changelog: component count corrected from 23 to 26 (22 pages documenting 26 components; the count predated the Cta page removal).
  • colors post: the gradient demos used a br-sm helper that doesn't exist; radius moved into the inline style.
  • select-mask post: GitHub line anchor updated for the current elements.form.css.
  • BEM post: one sentence-construction em dash replaced with a colon.

House style

  • CLAUDE.md's em dash rule clarified per Yann: legitimate typographic uses (ranges like h1h6, quote attribution, table placeholders) are fine; sentence-construction dashes are not. The h1h6 range in the elements docs was tidied to a closed-up en dash under the same rule.

Verification

  • npm run build:css: dist/ regenerated cleanly (meter token gone from dist, layer invariants intact).
  • npm run lint:css: clean.
  • npm run build: 110 pages, no errors; corrected tables, new sections, and class fixes confirmed in the built HTML.
  • npm run check: 0 errors, 0 warnings.

🤖 Generated with Claude Code

Framework and site CSS:
- Remove the orphan --meter-color token (nothing consumed it; the meter
  paints with --meter-color-track/low/med/high), noted in the changelog.
- Remove the dead radius-demo rule referencing the nonexistent
  --radius-drawn token (the docs table has 6 rows, the CSS styled 7).

Docs:
- tokens: fix the heading-sizes table (every row was one step smaller
  than the actual clamps), document the new --highlight-500 token,
  rename the font stack row to the real token name (mono), fix the
  font stack notice copy.
- media-queries: document the user-preference and device-capability
  queries (OSdark, motionOK, touch, forcedColors, etc.), fix the
  mangled "(width <section 768px)" cell, note -phone availability.
- start: align the states example with the block_element syntax
  (form_input/form_submit), point the preset-env mention at the right
  link, fix typos (Targeting, properties).
- components/start: correct the zero-JavaScript exceptions list (hero
  slideshow, TOC scrollspy, read progress bar fallback) and the copy
  about per-page file tables.
- featuregrid: document FeatureItem's titleClass/iconClass props.
- Bump lastUpdate on every page with content changes.

Blog:
- structure post: layer list updated for v1 (Pages layer removed,
  Theme layer added).
- 1.0 post and changelog: component count corrected to 26.
- colors post: replace the nonexistent br-sm helper with an inline
  border-radius.
- select-mask post: fix the drifted GitHub line anchor.
- BEM post: punctuation cleanup.

Also clarifies the em dash rule in CLAUDE.md: legitimate typographic
uses (ranges, quote attribution) are fine; sentence-construction
dashes are not.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@netlify

netlify Bot commented Jul 24, 2026

Copy link
Copy Markdown

Deploy Preview for mcssdev ready!

Name Link
🔨 Latest commit f637815
🔍 Latest deploy log https://app.netlify.com/projects/mcssdev/deploys/6a6392f637f78c000868368a
😎 Deploy Preview https://deploy-preview-49--mcssdev.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 98
Accessibility: 98
Best Practices: 100
SEO: 99
PWA: 70
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@minimaldesign
minimaldesign merged commit 9b15bcf into main Jul 24, 2026
5 checks passed
@minimaldesign
minimaldesign deleted the v1-audit-fixes branch July 24, 2026 16:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant