From a6423b6b4a8b8021bfe32a0f13c05f59af685b85 Mon Sep 17 00:00:00 2001 From: Dennis Lembree <473400+weboverhauls@users.noreply.github.com> Date: Mon, 20 Jul 2026 14:32:17 -0400 Subject: [PATCH 1/4] Add A11yScan workflow for accessibility checks --- .github/workflows/A11yScan-theHub.yml | 37 +++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 .github/workflows/A11yScan-theHub.yml diff --git a/.github/workflows/A11yScan-theHub.yml b/.github/workflows/A11yScan-theHub.yml new file mode 100644 index 00000000000..03696914cb9 --- /dev/null +++ b/.github/workflows/A11yScan-theHub.yml @@ -0,0 +1,37 @@ +name: A11yScan:opensource-guide +permissions: + contents: write +on: + workflow_dispatch: + schedule: + # runs on first of month at 9AM UTC + # https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax#onschedule + - cron: '00 09 01 * *' + +jobs: + accessibility_scanner: + runs-on: ubuntu-latest + steps: + - uses: github/accessibility-scanner@84a8f6de0b0f7df7ac2083386222388d0e74eeb9 # v3.3.0 + with: + urls: | # Provide a newline-delimited list of URLs to scan; more information below. + https://opensource.guide/ + https://opensource.guide/accessibility-best-practices-for-your-project/ + https://opensource.guide/security-best-practices-for-your-project/ + https://opensource.guide/maintaining-balance-for-open-source-maintainers/ + https://opensource.guide/how-to-contribute/ + https://opensource.guide/starting-a-project/ + https://opensource.guide/finding-users/ + https://opensource.guide/building-community/ + https://opensource.guide/best-practices/ + https://opensource.guide/leadership-and-governance/ + https://opensource.guide/getting-paid/ + https://opensource.guide/code-of-conduct/ + https://opensource.guide/metrics/ + https://opensource.guide/legal/ + https://opensource.guide/notices/ + repository: weboverhauls/opensource.guide # Provide a repository name-with-owner (in the format "primer/primer-docs"). This is where issues will be filed and where Copilot will open PRs; more information below. + token: ${{ secrets.GH_TOKEN_A11YSCAN_OSGUIDE_WebOverhauls }} # This token must have write access to the repo above (contents, issues, and PRs); more information below. Note: GitHub Actions’ `GITHUB_TOKEN` (https://docs.github.com/en/actions/tutorials/authenticate-with-github_token) cannot be used here. + cache_key: cached_findings-opensource-guide + skip_copilot_assignment: false + include_screenshots: false From 608c6751aa77a7bde7eeac4c5b7d6cc8ab2445c6 Mon Sep 17 00:00:00 2001 From: Dennis Lembree <473400+weboverhauls@users.noreply.github.com> Date: Mon, 20 Jul 2026 14:36:58 -0400 Subject: [PATCH 2/4] Update token for A11yScan configuration --- .github/workflows/A11yScan-theHub.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/A11yScan-theHub.yml b/.github/workflows/A11yScan-theHub.yml index 03696914cb9..1efe23c0bc7 100644 --- a/.github/workflows/A11yScan-theHub.yml +++ b/.github/workflows/A11yScan-theHub.yml @@ -31,7 +31,7 @@ jobs: https://opensource.guide/legal/ https://opensource.guide/notices/ repository: weboverhauls/opensource.guide # Provide a repository name-with-owner (in the format "primer/primer-docs"). This is where issues will be filed and where Copilot will open PRs; more information below. - token: ${{ secrets.GH_TOKEN_A11YSCAN_OSGUIDE_WebOverhauls }} # This token must have write access to the repo above (contents, issues, and PRs); more information below. Note: GitHub Actions’ `GITHUB_TOKEN` (https://docs.github.com/en/actions/tutorials/authenticate-with-github_token) cannot be used here. + token: ${{ secrets.GH_TOKEN_A11YSCAN_CLASSIC }} # This token must have write access to the repo above (contents, issues, and PRs); more information below. Note: GitHub Actions’ `GITHUB_TOKEN` (https://docs.github.com/en/actions/tutorials/authenticate-with-github_token) cannot be used here. cache_key: cached_findings-opensource-guide skip_copilot_assignment: false include_screenshots: false From 4e2cc70179abd764d3db95ddc1187d3e0e01b5ef Mon Sep 17 00:00:00 2001 From: Dennis Lembree <473400+weboverhauls@users.noreply.github.com> Date: Tue, 28 Jul 2026 10:06:15 -0400 Subject: [PATCH 3/4] misc tweaks for accuracy and consistency --- ...sibility-best-practices-for-your-project.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/_articles/accessibility-best-practices-for-your-project.md b/_articles/accessibility-best-practices-for-your-project.md index 4b9e7a00de4..18981cffd1b 100644 --- a/_articles/accessibility-best-practices-for-your-project.md +++ b/_articles/accessibility-best-practices-for-your-project.md @@ -43,9 +43,9 @@ Add a clear statement that sets expectations and makes it easy for users to repo ### Goals -* State measurable goals (like [WCAG AA](https://www.w3.org/TR/WCAG22/#wcag-2-layers-of-guidance) where feasible). -* Primary priorities, and how you meet them (keyboard and screen reader support, captions and transcripts, etc.). -* Any known limitations, and alternative workarounds (if present). +* State measurable goals and guidelines (like [WCAG AA](https://www.w3.org/TR/WCAG22/#wcag-2-layers-of-guidance) where feasible). +* Define primary priorities, and how you meet them (keyboard and screen reader support, captions and transcripts, etc.). +* Define any known limitations, and alternative workarounds (if present). ### Contributor requirements @@ -101,7 +101,7 @@ Documentation is often the first "UI" users touch. Make sure everyone can read i ### Tables * Use tables only for tabular data, not for layout. -* Include **header cells** (``) and use `scope` attributes to associate headers with data cells. +* Provide **header cells** to associate column and row headers with data cells. * Provide a **caption or summary** describing the table's purpose. ### Code blocks @@ -123,8 +123,8 @@ If your project has a web UI, these high-impact defaults will help all users. ### Semantics first -* Use native HTML elements (`

`, `