Skip to content

Docs/badge guide - #263

Draft
kathrinschalber wants to merge 30 commits into
developmentfrom
docs/badge-guide
Draft

Docs/badge guide#263
kathrinschalber wants to merge 30 commits into
developmentfrom
docs/badge-guide

Conversation

@kathrinschalber

@kathrinschalber kathrinschalber commented Jul 15, 2026

Copy link
Copy Markdown
Collaborator

💡 What is the current behavior?

GitHub Issue Number: #

🆕 What is the new behavior?

  • Added the usage guide including code spec for badges

👨‍💻 Help & support

Summary by CodeRabbit

  • New Features

    • Added comprehensive Badge documentation, including usage guidance, examples, API details, accessibility, and best practices.
    • Added Badge to the component overview and documentation navigation.
  • Documentation

    • Added guidance that Pills are deprecated and recommends label badges as an alternative.
    • Improved the Checkbox validation example layout.

@netlify

netlify Bot commented Jul 15, 2026

Copy link
Copy Markdown

Deploy Preview for industrial-experience ready!

Name Link
🔨 Latest commit cafd715
🔍 Latest deploy log https://app.netlify.com/projects/industrial-experience/deploys/6a6906f2d0bd5c0008a69c21
😎 Deploy Preview https://deploy-preview-263--industrial-experience.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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

@coderabbitai

coderabbitai Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 8409f7d6-14a1-4313-be21-bf9ffdad0228

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

Adds Badge usage and code documentation, registers Badge in component navigation, documents Pill deprecation in favor of label Badges, and increases the Checkbox validation playground height.

Changes

Badge documentation

Layer / File(s) Summary
Badge usage and code content
docs/components/badge/*
Adds Badge metadata, usage guidance, examples, playgrounds, and generated API props documentation.
Badge documentation navigation
docs/components/overview.md, sidebars.ts
Adds Badge to the component overview and sidebar tabs.
Pill deprecation guidance
docs/components/pill/*
Directs readers from deprecated Pills to label-type Badges.

Checkbox documentation

Layer / File(s) Summary
Validation playground sizing
docs/components/checkbox/code.mdx
Increases the validation playground height from 34rem to 36rem.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

Suggested reviewers: danielleroux

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title is concise and accurately reflects the main change: adding Badge documentation and a usage guide.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/badge-guide

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces the initial documentation structure and an ideation draft for the new Badge component, registering it in the sidebar. The review feedback highlights that several files still contain 'to be done' placeholders that need to be populated before merging, including integrating the draft content into the usage guide and defining the API properties. Additionally, the reviewer noted a couple of typos in the ideation draft and requested reordering the sidebar entry alphabetically to maintain consistency.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread docs/components/badge/guide.md Outdated
Comment thread docs/components/badge/code.mdx Outdated
Comment thread docs/components/badge/ideation.md Outdated
Comment thread docs/components/badge/ideation.md Outdated
Comment thread docs/components/badge/index.mdx Outdated
Comment thread sidebars.ts Outdated
Comment thread docs/components/badge/ideation.md Outdated
Comment thread docs/components/badge/ideation.md Outdated
Comment thread docs/components/badge/ideation.md Outdated
@flxlst09

Copy link
Copy Markdown
Collaborator

EIX-59

@flxlst09
flxlst09 changed the base branch from main to development July 20, 2026 13:13
@alexkaduk
alexkaduk changed the base branch from development to main July 21, 2026 05:57
@alexkaduk
alexkaduk changed the base branch from main to development July 21, 2026 05:58

@kathrinschalber kathrinschalber left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A couple questions to discuss :)

Comment thread docs/components/badge/ideation.md Outdated
Comment thread docs/components/badge/guide.md Outdated
Comment thread docs/components/badge/guide.md Outdated
Comment thread docs/components/badge/guide.md Outdated
Comment thread docs/components/badge/guide.md
Comment thread docs/components/badge/guide.md
Comment thread docs/components/badge/guide.md Outdated
Comment thread docs/components/badge/guide.md Outdated
Comment thread docs/components/badge/guide.md Outdated
Comment thread docs/components/badge/guide.md Outdated
Comment thread .env.pullrequest
alexkaduk and others added 5 commits July 27, 2026 20:52
Co-authored-by: Kathrin <123640803+kathrinschalber@users.noreply.github.com>
Refine badge component documentation with improved clarity and restructured content. Reorganize badge component earlier in the 'System feedback and status' section of the sidebar. Remove draft ideation document and production environment configuration file.
@kathrinschalber

Copy link
Copy Markdown
Collaborator Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor
✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/components/badge/guide.md`:
- Around line 85-89: Remove the shorter duplicate synchronization bullet from
the badge guidance list, keeping the more detailed “Keep badges synchronized
with the underlying notification state” entry and its additional update/removal
guidance unchanged.
- Line 75: Update the badge behavior paragraph to remove the ambiguous “enabled”
and “disabled” terminology; explicitly describe pulsing as conditional on the
Pulse animation option, or remove the pulsing sentence if that option is not
documented here.
- Line 82: Update the counter-label guidance in the Dos list to mention the same
short-word exception allowed by the Types section, while retaining the two-digit
integer limit and 99+ overflow behavior.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 3a791c88-2e08-4942-b210-226a92508a87

📥 Commits

Reviewing files that changed from the base of the PR and between a53578a and 3441cf7.

⛔ Files ignored due to path filters (4)
  • static/figma/wEptRgAezDU1z80Cn3eZ0o_8141_4052.png is excluded by !**/*.png
  • static/figma/wEptRgAezDU1z80Cn3eZ0o_8141_4066.png is excluded by !**/*.png
  • static/figma/wEptRgAezDU1z80Cn3eZ0o_8161_118.png is excluded by !**/*.png
  • static/figma/wEptRgAezDU1z80Cn3eZ0o_8173_214.png is excluded by !**/*.png
📒 Files selected for processing (8)
  • docs/components/badge/code.mdx
  • docs/components/badge/guide.md
  • docs/components/badge/index.mdx
  • docs/components/checkbox/code.mdx
  • docs/components/overview.md
  • docs/components/pill/code.mdx
  • docs/components/pill/guide.md
  • sidebars.ts

Comment thread docs/components/badge/guide.md Outdated
Comment thread docs/components/badge/guide.md Outdated
Comment thread docs/components/badge/guide.md Outdated
kathrinschalber and others added 5 commits July 28, 2026 13:36
Updates badge guidance in docs/components/badge/guide.md: clarifies that pulse animation loops continuously until explicitly disabled and may be hidden by some a11y browser configurations; removes the incorrect statement that badges pulse by default in the States section; refines Dos by allowing short words (e.g. "new") for counters, adds an example for keeping badges synchronized with notification state, and removes a duplicated synchronization line.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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.

3 participants