Skip to content

Update Accessibility docs #12513

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

Jump to bottom
Open
wants to merge 17 commits into
base: main
Choose a base branch
from
Open

Update Accessibility docs #12513

wants to merge 17 commits into from
+614 −434

Conversation

hannah-hyj
Copy link
Member

@hannah-hyj hannah-hyj commented Oct 3, 2025 •
edited
Loading

This PR did

  1. Split Accessibility and Internationalization into two tabs
  2. Update Accessibility docs to 5 parts
    • title: Introduction
    • title: UI Design & Styling
    • title: Assistive technologies
    • title: Accessibility testing
    • title: Web accessibility
  3. keep old content and add some new content
    • title: Introduction
      added standards and regulation
    • title: UI Design & Styling
      added pictures and touch target size.
    • title: Assistive technologies
      added mobility.
    • title: Accessibility testing
      added nothing.
    • title: Web accessibility
      added how to opt-in using button or code

Presubmit checklist

  • If you are unwilling, or unable, to sign the CLA, even for a tiny, one-word PR, please file an issue instead of a PR.
  • If this PR is not meant to land until a future stable release, mark it as draft with an explanation.
  • This PR follows the Google Developer Documentation Style Guidelines—for example, it doesn't use i.e. or e.g., and it avoids I and we (first-person pronouns).
  • This PR uses semantic line breaks
    of 80 characters or fewer.

@hannah-hyj hannah-hyj closed this Oct 3, 2025
@hannah-hyj hannah-hyj changed the title [Draft] Update Accessibility docs Update Accessibility docs Oct 4, 2025
@hannah-hyj hannah-hyj reopened this Oct 4, 2025
@hannah-hyj hannah-hyj marked this pull request as ready for review October 4, 2025 00:08
@hannah-hyj hannah-hyj requested review from sfshaza2 and a team as code owners October 4, 2025 00:08
@flutter-website-bot
Copy link
Collaborator

flutter-website-bot commented Oct 4, 2025 •
edited
Loading

Visit the preview URL for this PR (updated for commit a3f8e1e):

https://flutter-docs-prod--pr12513-refresh-a11y-2dmrp4ce.web.app

@hannah-hyj hannah-hyj requested a review from chunhtai October 4, 2025 00:16
sfshaza2
sfshaza2 approved these changes Oct 8, 2025
View reviewed changes
Copy link
Contributor

@sfshaza2 sfshaza2 left a comment

Choose a reason for hiding this comment

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

Fixing the broken link.

sfshaza2
sfshaza2 approved these changes Oct 8, 2025
View reviewed changes
Copy link
Contributor

@sfshaza2 sfshaza2 left a comment

Choose a reason for hiding this comment

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

@hannah-hyj, this is a FABULOUS update to the accessibility docs! I have some minor edits, to make the text more consistent and so forth (and I previously fixed a broken link), but this is SUPER appreciated!

sfshaza2
sfshaza2 reviewed Oct 8, 2025
View reviewed changes
@sfshaza2
Copy link
Contributor

sfshaza2 commented Oct 8, 2025

OK, I should have anticipated this. All sorts of internal links are breaking because of the new structure of the accessibility docs. I'm done for the day, but I can tackle this tomorrow. For one thing, we should set up redirects in the firebase.json file, so folks that link INTO our docs will end up at least roughly in the right place.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@sfshaza2 sfshaza2 sfshaza2 approved these changes

@chunhtai chunhtai Awaiting requested review from chunhtai

Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
3 participants
@hannah-hyj @flutter-website-bot @sfshaza2