Skip to content

Conversation

marcoscaceres
Copy link
Member

@marcoscaceres marcoscaceres commented Sep 3, 2025

Closes #120

This pull request adds new guidance to the documentation about responsible badge usage. The update emphasizes the importance of minimizing notification fatigue and ensuring accessibility for all users.

Badge usage guidelines for authors:

  • Added a new section under the heading "Responsible badge usage" to advise authors to reserve badges for important states and avoid using them for marketing or engagement purposes.
  • Included recommendations to avoid rapidly changing badge values that could distract users or increase cognitive load.
  • Encouraged authors to provide accessible alternatives for users who do not perceive badges, such as in-app status indicators with clear labels.

Preview | Diff

Copy link

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This pull request adds a new "Responsible badge usage" section to the documentation that provides guidance for authors on appropriate badge usage practices. The update focuses on preventing notification fatigue and ensuring accessibility for all users.

  • Introduces guidance on reserving badges for important states rather than marketing purposes
  • Recommends avoiding rapidly changing badge values to reduce cognitive load
  • Emphasizes providing accessible alternatives for users who cannot perceive badges

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@marcoscaceres marcoscaceres requested a review from diekus September 8, 2025 07:11
@marcoscaceres marcoscaceres merged commit b3154ee into main Sep 22, 2025
2 checks passed
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.

Spec lacks guidance on responsible use of Badging API and user distraction risks
2 participants