Skip to content

docs: accessibility planning package#5553

Open
accesswatch wants to merge 5 commits intomainfrom
docs/accessibility-planning-2026-04-23
Open

docs: accessibility planning package#5553
accesswatch wants to merge 5 commits intomainfrom
docs/accessibility-planning-2026-04-23

Conversation

@accesswatch
Copy link
Copy Markdown
Contributor

@accesswatch accesswatch commented Apr 23, 2026

Summary

  • add the accessibility planning and review package
  • publish meeting materials, send-out docs, and the send-ready HTML file
  • keep this branch documentation-only and separate from implementation work

Reviewer Focus

  • confirm the planning materials accurately reflect the live project dashboard and issue structure
  • confirm the documentation package is clear enough for Friday review and stakeholder circulation
  • confirm the GitHub links point to the dedicated planning branch and not the carousel patch branch
  • confirm the branch remains planning-only and does not introduce implementation work

Out Of Scope

  • do not review this PR as an accessibility remediation implementation
  • do not evaluate widget fixes, theme code changes, or runtime behavior here
  • implementation work remains separate from this planning package

Notes

  • the project dashboard remains a program-level asset
  • this branch exists only to store and review the planning package
  • no implementation changes are included

- 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
Copilot AI review requested due to automatic review settings April 23, 2026 22:24
@accesswatch accesswatch requested review from a team as code owners April 23, 2026 22:24
Copy link
Copy Markdown

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

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.

Comment on lines +31 to +43
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
Copy link

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

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

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.

Suggested change
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)

Copilot uses AI. Check for mistakes.
Comment on lines +32 to +46
- [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)
Copy link

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

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

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.

Suggested change
- [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)

Copilot uses AI. Check for mistakes.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I think repo relative links might actually be the best option here.

Comment on lines +20 to +23
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)
Copy link

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

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

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.

Copilot uses AI. Check for mistakes.
Comment on lines +19 to +23
- 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:
Copy link

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

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

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.

Copilot uses AI. Check for mistakes.
Comment on lines +21 to +22
- 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
Copy link

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

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

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.

Suggested change
- 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

Copilot uses AI. Check for mistakes.
Comment thread send.html Outdated
Comment on lines +106 to +113
<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>
Copy link

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

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

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.

Copilot uses AI. Check for mistakes.
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
Copy link

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

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

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.

Suggested change
- Auditor: GitHub Copilot
- Auditor: [Human reviewer name]
- Drafting/review assistance: GitHub Copilot

Copilot uses AI. Check for mistakes.
- 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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants