Skip to content

Conversation

@Moohan
Copy link
Owner

@Moohan Moohan commented Feb 5, 2026

💡 What:

  • Redirected GitHub stats cards to the user's profile.
  • Moved and updated title attributes for stats cards, social badges, and skills banner to be on the link instead of the image.
  • Improved tooltip text to be more descriptive and action-oriented (e.g., "View James Hayes's Mastodon profile").
  • Added explicit "(deprecated)" text next to the struck-through phssensitivitylabels link.

🎯 Why:

  • Clicking a stats card should logically take the visitor to the user's profile, not the tool used to generate the card.
  • Tooltips on links provide better context for the destination.
  • Screen readers might not announce strikethrough styling, so explicit text for deprecated items is necessary for accessibility.

♿ Accessibility:

  • Improved link descriptions for screen reader users via better tooltips.
  • Ensured deprecated status is communicated via text, not just visual styling.
  • Placed tooltips on interactive link elements for better focus/hover behavior.

PR created automatically by Jules for task 7560349995311447420 started by @Moohan

Summary by Sourcery

Improve accessibility and usability of README badges and project links.

Enhancements:

  • Move tooltip titles from images to their associated links for skills, stats, and social badges to improve accessibility and UX.
  • Clarify that the phssensitivitylabels package is deprecated in the project description.
  • Update GitHub stats cards so clicking them navigates to the user’s GitHub profile instead of the stats tool site.

Summary by CodeRabbit

  • Documentation
    • Updated multiple profile badges with improved links that now direct users to official profile pages instead of secondary statistics endpoints, with clearer descriptive titles.
    • Added deprecation notice for phssensitivitylabels, documenting that its functionality is now fully integrated within phstemplates.

Co-authored-by: Moohan <5982260+Moohan@users.noreply.github.com>
@google-labs-jules
Copy link
Contributor

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.


For security, I will only act on instructions from the user who triggered this task.

@sourcery-ai
Copy link

sourcery-ai bot commented Feb 5, 2026

Reviewer's guide (collapsed on small PRs)

Reviewer's Guide

Adjusts README badges and links to improve accessibility by moving tooltip titles from images to links, updating link destinations for GitHub stats cards, clarifying social/profile tooltip text, and explicitly marking a deprecated package link in text.

Flow diagram for README badge and tooltip behavior

flowchart TD
  A_User_views_README --> B_Sees_visual_badges
  B_Sees_visual_badges --> C_Hover_or_focus_badge
  C_Hover_or_focus_badge --> D_Tooltip_from_link_title
  D_Tooltip_from_link_title --> E_Action_oriented_description

  subgraph GitHub_stats_cards
    F_Image_card[Stats_card_image]
    G_Link_profile[Link_to_GitHub_profile]
    F_Image_card --> G_Link_profile
    G_Link_profile --> H_Tooltip_View_profile[Link_title_View_James_Hayes_GitHub_profile]
  end

  subgraph Social_and_ID_badges
    I_ORCID_badge[ORCID_badge_image]
    J_Mastodon_badge[Mastodon_badge_image]
    K_Bluesky_badge[Bluesky_badge_image]

    I_ORCID_badge --> L_ORCID_link[Link_to_ORCID_profile]
    J_Mastodon_badge --> M_Mastodon_link[Link_to_Mastodon_profile]
    K_Bluesky_badge --> N_Bluesky_link[Link_to_Bluesky_profile]

    L_ORCID_link --> L1_ORCID_title[Link_title_View_ORCID_profile]
    M_Mastodon_link --> M1_Mastodon_title[Link_title_View_Mastodon_profile]
    N_Bluesky_link --> N1_Bluesky_title[Link_title_View_Bluesky_profile]
  end

  subgraph Deprecated_package_text
    O_phstemplates_item[phstemplates_description_text]
    P_phssensitivitylabels_link[Link_to_phssensitivitylabels]
    Q_deprecated_label[Text_deprecated]
    O_phstemplates_item --> P_phssensitivitylabels_link
    P_phssensitivitylabels_link --> Q_deprecated_label
  end

  E_Action_oriented_description --> O1_Improved_accessibility[Improved_screen_reader_context]
Loading

File-Level Changes

Change Details Files
Move tooltip titles from images to their wrapping links for skills banner, GitHub stats cards, and social profile badges to improve accessibility and UX.
  • Remove title attributes from badge and card image elements
  • Add equivalent or improved title attributes to the surrounding anchor links
  • Ensure tooltips describe the resulting action or destination rather than the image itself
README.md
Update GitHub stats card links to point to the user’s GitHub profile instead of the stats generator project.
  • Change href of main GitHub stats card link to the user’s GitHub profile URL
  • Change href of top-languages stats card link to the user’s GitHub profile URL
  • Adjust link titles to clearly state that the link opens the user’s GitHub profile
README.md
Clarify deprecated status of the phssensitivitylabels package in text for better screen reader support.
  • Append explicit “(deprecated)” text after the struck-through phssensitivitylabels link
README.md

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 5, 2026

Walkthrough

README.md badges updated to restructure link and title semantics across technical skills, GitHub statistics, and social profiles. Outer anchors now carry profile-oriented titles while inner images are adjusted accordingly. Added deprecation note for phssensitivitylabels in phstemplates entry.

Changes

Cohort / File(s) Summary
Markdown Badge Restructuring
README.md
Reorganised badge markup to move title attributes between image and anchor elements; updated GitHub stats badge anchors to point to profile pages; adjusted social profile badges (ORCID, Mastodon, Bluesky) with descriptive titles on outer links. Added deprecation note for phssensitivitylabels within phstemplates entry.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title mentions improving accessibility and UX of README badges and links, which directly aligns with the main changes involving badge restructuring, tooltip improvements, and accessibility enhancements.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch palette-readme-improvements-7560349995311447420

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 and usage tips.

Copy link

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

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

Hey - I've left some high level feedback:

  • For the two GitHub stats links, consider differentiating the title text so that each tooltip reflects the specific card (e.g. one for overall stats, one for top languages) rather than using the same generic profile description for both.
  • You might want to include the "(deprecated)" marker inside the linked phssensitivitylabels text (or in its tooltip) as well, so that the deprecation status is clearly conveyed to assistive technologies that focus on link text alone.
Prompt for AI Agents
Please address the comments from this code review:

## Overall Comments
- For the two GitHub stats links, consider differentiating the `title` text so that each tooltip reflects the specific card (e.g. one for overall stats, one for top languages) rather than using the same generic profile description for both.
- You might want to include the "(deprecated)" marker inside the linked `phssensitivitylabels` text (or in its tooltip) as well, so that the deprecation status is clearly conveyed to assistive technologies that focus on link text alone.

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

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