GitHub 现在会在仓库概览页识别并展示 ACCESSIBILITY.md,让无障碍目标、贡献要求、支持环境、已知障碍和问题反馈流程拥有一个固定入口。该文件可以放在仓库根目录、.github 目录或 docs 目录;仓库也可以继承所属组织在 .github 仓库中的声明。公共仓库维护者可在 Insights 的 Community Standards 中添加或提交声明建议,新仓库还会默认带有无障碍问题标签,便于整理和跟踪反馈。
让分散信息更容易找到
无障碍信息过去常散落在问题追踪器、贡献指南、审计报告、团队知识库和用户沟通中。遇到障碍的人需要自行搜索,维护者也容易因贡献者更替而丢失上下文。把这些内容集中到仓库概览页可见的文件后,用户、贡献者和维护者都能从同一入口了解项目如何处理无障碍问题。
ACCESSIBILITY.md 也与 GitHub 现有的社区健康文件形成互补:贡献指南说明如何提交改动,行为准则界定参与 expectations,安全政策解释漏洞报告方式,而无障碍声明专门说明如何发现、反馈和修复无障碍障碍。
不同项目可以记录不同内容
- GitHub CLI 的声明记录了表格输出可能难以被屏幕阅读器理解的问题,并提供将拉取请求编号和标题逐行输出的替代命令;修改提示或输出的贡献者还被要求展示启用相关无障碍设置后的结果。
- GitHub Annotation Toolkit 的声明指出,其 Figma 库通过画布位置、连接线和匹配数字表达关系,但访问单个画布对象不一定能传达这些关系。因此,协作者需要同时提供结构化文本说明,交代标注元素、语义、行为和顺序。声明也明确说明该库尚未接受纯键盘或屏幕阅读器测试。
一份可维护的声明应覆盖什么
- 项目重视的无障碍目标及适用体验;
- 对人工贡献者和编码代理的检查、证据与审查要求;
- 直接且可访问的问题反馈渠道,不要求披露残障身份,截图和录屏仅作为可选材料;
- 维护者确认、分流、跟踪、沟通和处理修复的流程;
- 已经支持或测试的平台、浏览器、输入方式及辅助技术;
- 已知障碍、可用替代方案及对应的修复工作;
- 负责更新声明的团队、角色或维护者,以及改进反馈方式。
目标声明不等于合规结论
ACCESSIBILITY.md 没有统一格式,小型库、命令行工具、文档站点和大型应用应从能够长期保持准确的信息开始。项目可以引用特定版本的《网页内容无障碍指南》及其级别作为目标,但这只代表发展方向,不能证明已经符合标准。若要作出合规声明,还需要说明评估范围、日期、方法和评估者。更实用的写法是使用清楚语言,明确反馈时需要提供哪些上下文,同时公布维护者能够稳定提供的确认进度、状态更新、临时替代方案和修复核验方式。
资料来源:Accessibility statements now have a home on GitHub(2026-11-05)。
一起聊聊
留下你的想法,评论审核通过后展示。