docs: accessibility planning package#5553
Conversation
- add WCAG 2.2 AA review and planning documents - add meeting and send-out materials - add send-ready HTML review package - retarget links to the dedicated planning branch
There was a problem hiding this comment.
Pull request overview
Adds an accessibility planning/review documentation package for the az_quickstart WCAG 2.2 AA effort, including send-out materials and Friday meeting support docs, with no implementation changes.
Changes:
- Adds a source-level accessibility review/remediation plan and a GitHub project execution plan (phases, issues, operating model).
- Publishes Friday meeting materials (agenda, facilitator script, talk track, post-meeting notes template) and stakeholder send-out drafts.
- Adds a “send-ready” HTML file intended for browser/email reuse that links to the published planning artifacts.
Reviewed changes
Copilot reviewed 13 out of 13 changed files in this pull request and generated 7 comments.
Show a summary per file
| File | Description |
|---|---|
| send.html | Send-ready HTML message linking to the program board and planning artifacts. |
| ACCESSIBILITY-SENDOUT-BRIEF.md | Single index/brief consolidating links to the board, issues, and planning docs. |
| ACCESSIBILITY-REVIEW-PLAN.md | Source-level accessibility findings and phased remediation/verification plan. |
| ACCESSIBILITY-PROJECT-VIEWS-HANDOFF.md | Recommended GitHub Project views and manual setup guidance for saved views. |
| ACCESSIBILITY-PROGRAM-EMAIL-DRAFT.md | Internal team email draft summarizing the planning package and links. |
| ACCESSIBILITY-POST-MEETING-NOTES-TEMPLATE.md | Template for capturing decisions and follow-ups from the Friday meeting. |
| ACCESSIBILITY-LIVE-PRESENTATION-TALK-TRACK.md | Short talk track for presenting the program structure and decision queue. |
| ACCESSIBILITY-GITHUB-PROJECT-PLAN.md | Detailed GitHub program structure, phases, issues, and operating model. |
| ACCESSIBILITY-FRIDAY-MEETING-AGENDA.md | Proposed agenda and facilitation structure for the Friday planning meeting. |
| ACCESSIBILITY-FRIDAY-HANDOUT.md | One-page snapshot handout with key links and decision queue. |
| ACCESSIBILITY-FRIDAY-FACILITATOR-SCRIPT.md | Facilitator script to keep meeting focused on decisions and sequencing. |
| ACCESSIBILITY-FINAL-REVIEW-EMAIL.md | Send-ready stakeholder email summarizing the package with primary links. |
| ACCESSIBILITY-EXECUTIVE-EMAIL-DRAFT.md | Short executive-facing email draft highlighting artifacts and decisions. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| These files currently live on the dedicated `docs/accessibility-planning-2026-04-23` planning branch and can be viewed directly in GitHub with the links below. | ||
|
|
||
| - Review plan: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-REVIEW-PLAN.md | ||
| - GitHub execution plan: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-GITHUB-PROJECT-PLAN.md | ||
| - Friday meeting agenda: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-FRIDAY-MEETING-AGENDA.md | ||
| - Facilitator script: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-FRIDAY-FACILITATOR-SCRIPT.md | ||
| - Project views handoff: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-PROJECT-VIEWS-HANDOFF.md | ||
| - Post-meeting notes template: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-POST-MEETING-NOTES-TEMPLATE.md | ||
| - Live presentation talk track: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-LIVE-PRESENTATION-TALK-TRACK.md | ||
| - Team email draft: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-PROGRAM-EMAIL-DRAFT.md | ||
| - Executive email draft: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-EXECUTIVE-EMAIL-DRAFT.md | ||
| - Final review email: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-FINAL-REVIEW-EMAIL.md | ||
| - One-page Friday handout: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-FRIDAY-HANDOUT.md |
There was a problem hiding this comment.
Several links hard-code the temporary planning branch name (blob/docs/accessibility-planning-2026-04-23/...). If this PR is merged (or the branch is later deleted/renamed), these URLs will be stale and the send-out brief becomes inaccurate. Consider switching to repo-relative links (e.g., ./ACCESSIBILITY-REVIEW-PLAN.md) or blob/main/... once the docs are on the default branch, and avoid stating the docs “currently live” on a specific branch in a file that will live on main.
| These files currently live on the dedicated `docs/accessibility-planning-2026-04-23` planning branch and can be viewed directly in GitHub with the links below. | |
| - Review plan: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-REVIEW-PLAN.md | |
| - GitHub execution plan: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-GITHUB-PROJECT-PLAN.md | |
| - Friday meeting agenda: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-FRIDAY-MEETING-AGENDA.md | |
| - Facilitator script: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-FRIDAY-FACILITATOR-SCRIPT.md | |
| - Project views handoff: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-PROJECT-VIEWS-HANDOFF.md | |
| - Post-meeting notes template: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-POST-MEETING-NOTES-TEMPLATE.md | |
| - Live presentation talk track: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-LIVE-PRESENTATION-TALK-TRACK.md | |
| - Team email draft: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-PROGRAM-EMAIL-DRAFT.md | |
| - Executive email draft: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-EXECUTIVE-EMAIL-DRAFT.md | |
| - Final review email: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-FINAL-REVIEW-EMAIL.md | |
| - One-page Friday handout: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-FRIDAY-HANDOUT.md | |
| The planning documents are linked below for easy access: | |
| - Review plan: [ACCESSIBILITY-REVIEW-PLAN.md](./ACCESSIBILITY-REVIEW-PLAN.md) | |
| - GitHub execution plan: [ACCESSIBILITY-GITHUB-PROJECT-PLAN.md](./ACCESSIBILITY-GITHUB-PROJECT-PLAN.md) | |
| - Friday meeting agenda: [ACCESSIBILITY-FRIDAY-MEETING-AGENDA.md](./ACCESSIBILITY-FRIDAY-MEETING-AGENDA.md) | |
| - Facilitator script: [ACCESSIBILITY-FRIDAY-FACILITATOR-SCRIPT.md](./ACCESSIBILITY-FRIDAY-FACILITATOR-SCRIPT.md) | |
| - Project views handoff: [ACCESSIBILITY-PROJECT-VIEWS-HANDOFF.md](./ACCESSIBILITY-PROJECT-VIEWS-HANDOFF.md) | |
| - Post-meeting notes template: [ACCESSIBILITY-POST-MEETING-NOTES-TEMPLATE.md](./ACCESSIBILITY-POST-MEETING-NOTES-TEMPLATE.md) | |
| - Live presentation talk track: [ACCESSIBILITY-LIVE-PRESENTATION-TALK-TRACK.md](./ACCESSIBILITY-LIVE-PRESENTATION-TALK-TRACK.md) | |
| - Team email draft: [ACCESSIBILITY-PROGRAM-EMAIL-DRAFT.md](./ACCESSIBILITY-PROGRAM-EMAIL-DRAFT.md) | |
| - Executive email draft: [ACCESSIBILITY-EXECUTIVE-EMAIL-DRAFT.md](./ACCESSIBILITY-EXECUTIVE-EMAIL-DRAFT.md) | |
| - Final review email: [ACCESSIBILITY-FINAL-REVIEW-EMAIL.md](./ACCESSIBILITY-FINAL-REVIEW-EMAIL.md) | |
| - One-page Friday handout: [ACCESSIBILITY-FRIDAY-HANDOUT.md](./ACCESSIBILITY-FRIDAY-HANDOUT.md) |
| - [Consolidated send-out brief](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-SENDOUT-BRIEF.md) | ||
| - [One-page Friday handout](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-FRIDAY-HANDOUT.md) | ||
|
|
||
| ## Detailed Planning Documents | ||
|
|
||
| - [Accessibility review plan](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-REVIEW-PLAN.md) | ||
| - [GitHub execution plan](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-GITHUB-PROJECT-PLAN.md) | ||
|
|
||
| ## Friday Meeting Materials | ||
|
|
||
| - [Meeting agenda](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-FRIDAY-MEETING-AGENDA.md) | ||
| - [Facilitator script](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-FRIDAY-FACILITATOR-SCRIPT.md) | ||
| - [Presentation talk track](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-LIVE-PRESENTATION-TALK-TRACK.md) | ||
| - [Project views handoff](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-PROJECT-VIEWS-HANDOFF.md) | ||
| - [Post-meeting notes template](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-POST-MEETING-NOTES-TEMPLATE.md) |
There was a problem hiding this comment.
This email uses blob/docs/accessibility-planning-2026-04-23/... links. If the planning branch is deleted/renamed or if these docs are merged into main, recipients following the saved email text later will hit broken/stale URLs. Consider using repo-relative links or blob/main/... for long-lived docs, and reserve branch-specific links only for truly short-lived drafts.
| - [Consolidated send-out brief](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-SENDOUT-BRIEF.md) | |
| - [One-page Friday handout](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-FRIDAY-HANDOUT.md) | |
| ## Detailed Planning Documents | |
| - [Accessibility review plan](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-REVIEW-PLAN.md) | |
| - [GitHub execution plan](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-GITHUB-PROJECT-PLAN.md) | |
| ## Friday Meeting Materials | |
| - [Meeting agenda](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-FRIDAY-MEETING-AGENDA.md) | |
| - [Facilitator script](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-FRIDAY-FACILITATOR-SCRIPT.md) | |
| - [Presentation talk track](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-LIVE-PRESENTATION-TALK-TRACK.md) | |
| - [Project views handoff](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-PROJECT-VIEWS-HANDOFF.md) | |
| - [Post-meeting notes template](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-POST-MEETING-NOTES-TEMPLATE.md) | |
| - [Consolidated send-out brief](https://github.com/az-digital/az_quickstart/blob/main/ACCESSIBILITY-SENDOUT-BRIEF.md) | |
| - [One-page Friday handout](https://github.com/az-digital/az_quickstart/blob/main/ACCESSIBILITY-FRIDAY-HANDOUT.md) | |
| ## Detailed Planning Documents | |
| - [Accessibility review plan](https://github.com/az-digital/az_quickstart/blob/main/ACCESSIBILITY-REVIEW-PLAN.md) | |
| - [GitHub execution plan](https://github.com/az-digital/az_quickstart/blob/main/ACCESSIBILITY-GITHUB-PROJECT-PLAN.md) | |
| ## Friday Meeting Materials | |
| - [Meeting agenda](https://github.com/az-digital/az_quickstart/blob/main/ACCESSIBILITY-FRIDAY-MEETING-AGENDA.md) | |
| - [Facilitator script](https://github.com/az-digital/az_quickstart/blob/main/ACCESSIBILITY-FRIDAY-FACILITATOR-SCRIPT.md) | |
| - [Presentation talk track](https://github.com/az-digital/az_quickstart/blob/main/ACCESSIBILITY-LIVE-PRESENTATION-TALK-TRACK.md) | |
| - [Project views handoff](https://github.com/az-digital/az_quickstart/blob/main/ACCESSIBILITY-PROJECT-VIEWS-HANDOFF.md) | |
| - [Post-meeting notes template](https://github.com/az-digital/az_quickstart/blob/main/ACCESSIBILITY-POST-MEETING-NOTES-TEMPLATE.md) |
There was a problem hiding this comment.
I think repo relative links might actually be the best option here.
| 1. Accessibility review plan: | ||
| [ACCESSIBILITY-REVIEW-PLAN.md](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-REVIEW-PLAN.md) | ||
| 2. GitHub execution plan: | ||
| [ACCESSIBILITY-GITHUB-PROJECT-PLAN.md](https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-GITHUB-PROJECT-PLAN.md) |
There was a problem hiding this comment.
This handout hard-codes the planning branch name in documentation URLs. Once these files are merged into the default branch, these links will point at the old branch and can break. Consider replacing with repo-relative links (preferred for intra-repo docs) or updating to blob/main/... after merge.
| - A source-level accessibility review and remediation plan in GitHub: | ||
| - https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-REVIEW-PLAN.md | ||
| - A GitHub execution plan with issue structure and phase logic: | ||
| - https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-GITHUB-PROJECT-PLAN.md | ||
| - A live GitHub project board: |
There was a problem hiding this comment.
The draft email embeds branch-specific blob/docs/accessibility-planning-2026-04-23/... URLs. If this content is reused after the planning branch is removed or the docs move to main, the links will be wrong. Consider using repo-relative links or blob/main/... for anything intended to be reusable beyond this branch.
| - Review plan in GitHub: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-REVIEW-PLAN.md | ||
| - GitHub execution plan in GitHub: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-GITHUB-PROJECT-PLAN.md |
There was a problem hiding this comment.
This executive email draft includes blob/docs/accessibility-planning-2026-04-23/... links, which are likely to become stale once the docs are merged or the planning branch is cleaned up. Consider switching to repo-relative links or blob/main/... so the draft remains accurate if forwarded later.
| - Review plan in GitHub: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-REVIEW-PLAN.md | |
| - GitHub execution plan in GitHub: https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-GITHUB-PROJECT-PLAN.md | |
| - Review plan in GitHub: https://github.com/az-digital/az_quickstart/blob/main/ACCESSIBILITY-REVIEW-PLAN.md | |
| - GitHub execution plan in GitHub: https://github.com/az-digital/az_quickstart/blob/main/ACCESSIBILITY-GITHUB-PROJECT-PLAN.md |
| <tr> | ||
| <td style="border-radius: 4px; background-color: #ffffff;"> | ||
| <a href="https://github.com/az-digital/az_quickstart/blob/docs/accessibility-planning-2026-04-23/ACCESSIBILITY-FRIDAY-HANDOUT.md" style="display: block; padding: 14px 18px; border: 1px solid #005a9c; font-size: 16px; line-height: 20px; font-weight: 700; text-decoration: none; color: #005a9c; border-radius: 4px;"> | ||
| <span style="color: #005a9c;">Read The One-Page Friday Handout</span> | ||
| </a> | ||
| </td> | ||
| </tr> | ||
| </table> |
There was a problem hiding this comment.
This HTML “send-ready” file hard-codes links to blob/docs/accessibility-planning-2026-04-23/.... If the intent is for this file to remain usable after merge, those URLs will be fragile (branch deletion/rename, or docs moving to main). Consider using blob/main/... or linking to the repo-relative file paths once merged, and keep branch-specific links only for short-lived review cycles.
| This document captures a source-level accessibility review of az_quickstart and a prioritized remediation plan for reaching and maintaining WCAG 2.2 AA conformance. | ||
|
|
||
| - Audit date: April 23, 2026 | ||
| - Auditor: GitHub Copilot |
There was a problem hiding this comment.
The audit metadata lists the “Auditor” as GitHub Copilot. Since this document is explicitly a source-level review and not a certification, consider clarifying authorship (e.g., human reviewer name + “assisted by GitHub Copilot”) to avoid the impression of a formal third-party audit or a single accountable individual being omitted.
| - Auditor: GitHub Copilot | |
| - Auditor: [Human reviewer name] | |
| - Drafting/review assistance: GitHub Copilot |
- streamline send.html for leadership review - reduce detail to board, decisions, and primary links - keep email-safe structure and published planning links
- add recommended starting positions to Friday materials - emphasize targeted high-visibility first-wave work - rewrite send.html intro with a friendlier team-oriented tone - note that a dedicated review meeting may be appropriate
- rewrite send.html as a simple Outlook-paste-friendly document - remove all table-based email layout markup - keep the same planning content and primary links
- add preliminary phase 0 operating docs for verification, triage, sign-off, and representative URL mapping - update Friday handout, agenda, facilitator script, talk track, and notes template to point at the phase 0 working drafts - link the new material to phase 0 planning issues #5532, #5541, and #5539 without treating the docs as final policy Refs #5532 Refs #5541 Refs #5539
Summary
Reviewer Focus
Out Of Scope
Notes