Skip to content

🎨 Palette: accessibility and UX improvements to README.md #42

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Moohan wants to merge 1 commit into
base: main
Choose a base branch
from
Open

🎨 Palette: accessibility and UX improvements to README.md #42

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions .Jules/palette.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,3 +3,9 @@
**Learning:** A logical and sequential heading structure (e.g., `h1` -> `h2` -> `h3`) is not just for visual hierarchy, but is critical for screen reader users to navigate and understand the content of a page. Skipping heading levels can be confusing and disrupt the user's mental model of the document.

**Action:** When working with Markdown or HTML, always ensure the heading levels are sequential and logically structured. Do not skip levels for stylistic reasons.

## 2026-02-04 - Markdown Link Tooltip Placement

**Learning:** When wrapping an image in a link in Markdown, placing the `title` attribute on the link part (`[![alt](img_url)](link_url "title")`) rather than the image part (`![alt](img_url "title")`) ensures that the tooltip correctly describes the link's destination, providing better context for both visual and screen reader users.

**Action:** Always prefer placing descriptive tooltips on the outer link element when using linked images in Markdown.
14 changes: 7 additions & 7 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ When I'm not wrangling data or responding to emergencies, I enjoy exploring my h

Here are some of the technologies I work with:

[![My technical skills: R, Python, Git, GitHub, GitHub Actions, and Docker](https://skillicons.dev/icons?i=r,python,git,github,githubactions,docker "My technical skills")](https://skillicons.dev)
[![My technical skills: R, Python, Git, GitHub, GitHub Actions, and Docker](https://skillicons.dev/icons?i=r,python,git,github,githubactions,docker)](https://skillicons.dev "Visit skillicons.dev")

I'm particularly proficient in R's `tidyverse` ecosystem for data manipulation and visualisation, and I have extensive experience in mentoring and training others in these skills.

Expand All @@ -29,19 +29,19 @@ Here are some of the projects I'm proud to have worked on:
* **[phsmethods](https://github.com/Public-Health-Scotland/phsmethods "View the phsmethods package on GitHub"):** A collection of standardised methods for common analytical tasks in Public Health Scotland, improving efficiency and reproducibility.
* **[phsopendata](https://github.com/Public-Health-Scotland/phsopendata "View the phsopendata package on GitHub"):** A package that simplifies access to data from the Scottish Health and Social Care Open Data platform.
* **[phslookups](https://github.com/Public-Health-Scotland/phslookups "View the phslookups package on GitHub"):** A package for working with PHS lookup files.
* **[phstemplates](https://github.com/Public-Health-Scotland/phstemplates "View the phstemplates package on GitHub"):** An R package for creating standardised R projects and documents at Public Health Scotland. The functionality from [~~`phssensitivitylabels`~~](https://github.com/Moohan/phssensitivitylabels "View the phssensitivitylabels package on GitHub") has been incorporated into this package.
* **[phstemplates](https://github.com/Public-Health-Scotland/phstemplates "View the phstemplates package on GitHub"):** An R package for creating standardised R projects and documents at Public Health Scotland. The functionality from [~~`phssensitivitylabels`~~ (deprecated)](https://github.com/Moohan/phssensitivitylabels "View the phssensitivitylabels package on GitHub") has been incorporated into this package.

## GitHub Stats

Here's a snapshot of my GitHub activity:

[![A GitHub stats card showing James Hayes's contributions, stars, commits, and PRs.](https://github-readme-stats.vercel.app/api?username=Moohan&show_icons=true&theme=radical "My GitHub stats")](https://github.com/anuraghazra/github-readme-stats)
[![A card showing James Hayes's top languages on GitHub.](https://github-readme-stats.vercel.app/api/top-langs/?username=Moohan&layout=compact&theme=radical "My top languages")](https://github.com/anuraghazra/github-readme-stats)
[![A GitHub stats card showing James Hayes's contributions, stars, commits, and PRs.](https://github-readme-stats.vercel.app/api?username=Moohan&show_icons=true&theme=radical)](https://github.com/Moohan "View James Hayes's GitHub profile")
[![A card showing James Hayes's top languages on GitHub.](https://github-readme-stats.vercel.app/api/top-langs/?username=Moohan&layout=compact&theme=radical)](https://github.com/Moohan "View James Hayes's GitHub profile")

## Contact

I prefer to be contacted by email. You can reach me at the email address associated with my GitHub account.

[![ORCID profile for James Hayes with ID 0000-0002-5380-2029](https://img.shields.io/badge/ORCID-0000--0002--5380--2029-a6ce39?style=social&logo=orcid "My ORCID profile")](https://orcid.org/0000-0002-5380-2029)
[![Mastodon profile for James Hayes (@james_mcmahon@mastodon.scot)](https://img.shields.io/badge/Mastodon-@james__mcmahon@mastodon.scot-6364ff?style=social&logo=mastodon "My Mastodon profile")](https://mastodon.scot/@james_mcmahon)
[![Bluesky profile for James Hayes (@strathview.uk)](https://img.shields.io/badge/Bluesky-@strathview.uk-1da1f2?style=social&logo=bluesky "My Bluesky profile")](https://bsky.app/profile/strathview.uk)
[![ORCID profile for James Hayes with ID 0000-0002-5380-2029](https://img.shields.io/badge/ORCID-0000--0002--5380--2029-a6ce39?style=social&logo=orcid)](https://orcid.org/0000-0002-5380-2029 "View James Hayes's ORCID profile")
[![Mastodon profile for James Hayes (@james_mcmahon@mastodon.scot)](https://img.shields.io/badge/Mastodon-@james__mcmahon@mastodon.scot-6364ff?style=social&logo=mastodon)](https://mastodon.scot/@james_mcmahon "View James Hayes's Mastodon profile")
[![Bluesky profile for James Hayes (@strathview.uk)](https://img.shields.io/badge/Bluesky-@strathview.uk-1da1f2?style=social&logo=bluesky)](https://bsky.app/profile/strathview.uk "View James Hayes's Bluesky profile")