Skip to content

docs(Avatar): restore the missing dense best-practice bullet - #5330

Open
josephfarina wants to merge 1 commit into
mainfrom
navi/docs/dense-coverage-avatar-bullet
Open

docs(Avatar): restore the missing dense best-practice bullet#5330
josephfarina wants to merge 1 commit into
mainfrom
navi/docs/dense-coverage-avatar-bullet

Conversation

@josephfarina

Copy link
Copy Markdown
Contributor

What

The English Avatar docs list eight best practices; docsDense had only seven. The "do not name an interactive avatar with a status label" anti-pattern (guidance:false) had been folded onto the end of the interactive-avatar bullet (guidance:true), which dropped its own position and its guidance flag. The dense compression protocol requires 1:1 count parity with English, matching the guidance flag at each position, and never packing two English bullets into one.

Split the anti-pattern back into its own guidance:false bullet. Dense now matches English 8/8 with the same guidance sequence (true x5, false x3).

Checks

  • pnpm --filter @astryxdesign/core typecheck:docs passes
  • astryx component Avatar --lang dense renders eight best practices, five Do and three Don't

Night Watch — Doc Reviewer

The English docs list eight best practices; docsDense had seven. The
'do not name an interactive avatar with a status label' anti-pattern was
folded into the interactive-avatar bullet, dropping its own position and
its guidance:false flag. Split it back out so dense matches English 1:1
in count and guidance flag per position.

Found during Night Watch doc review.

Night Watch — Doc Reviewer
@vercel

vercel Bot commented Aug 22, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
astryx Ready Ready Preview Aug 22, 2026 9:22am

Request Review

@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Meta Open Source bot. label Aug 22, 2026
@github-actions

Copy link
Copy Markdown
Contributor

PR Analysis Report

📚 Storybook Preview

View Storybook for this PR
GitHub Pages may take up to a minute to hydrate after deploy.

🧪 Sandbox Preview

View Sandbox for this PR
GitHub Pages may take up to a minute to hydrate after deploy.

Modified Components

Avatar (@astryxdesign/core) · View in Storybook
Metric Before After Delta
Bundle Size (ESM) N/A N/A N/A
Lines of Code N/A 695 -
Complexity N/A Very High (85) -

Bundle Size Summary

Package Size (ESM) Size (CJS) Gzipped
@astryxdesign/core N/A 4.8KB 1.2KB

Accessibility Audit

Status: No accessibility violations detected.


Generated by PR Enrichment workflow | Storybook | Sandbox | View full report

github-actions Bot added a commit that referenced this pull request Aug 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Meta Open Source bot.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant