· 5 phút đọc
Tuyên bố về khả năng tiếp cận nay đã có chỗ riêng trên GitHub
Công việc về khả năng tiếp cận thường nằm rải rác trong các issue tracker, hướng dẫn đóng góp, báo cáo kiểm toán, kiến thức của nhóm và các cuộc trao đổi với người dùng. Khi thông tin đó ha
Công việc về khả năng tiếp cận thường nằm rải rác trong các issue tracker, hướng dẫn đóng góp, báo cáo kiểm toán, kiến thức của nhóm và các cuộc trao đổi với người dùng. Khi thông tin đó không có một nơi cố định dễ đoán, những người gặp rào cản phải tự đi tìm, còn người bảo trì thì mất ngữ cảnh khi người đóng góp và quyền sở hữu dự án thay đổi.
Một tệp ACCESSIBILITY.md, nay hiển thị trên trang tổng quan của kho lưu trữ, cho dự án một nơi lâu dài duy nhất để giải thích các mục tiêu về khả năng tiếp cận, kỳ vọng đối với người đóng góp, các môi trường được hỗ trợ, các hạn chế đã biết và quy trình báo cáo rào cản.
GitHub giúp tìm thấy tuyên bố về khả năng tiếp cận dễ dàng hơn

GitHub nay nhận diện tệp ACCESSIBILITY.md ở thư mục gốc của kho lưu trữ, trong thư mục .github/ hoặc docs/. Một kho lưu trữ cũng có thể kế thừa tuyên bố từ kho lưu trữ .github/ của tổ chức. Với các kho lưu trữ công khai, người bảo trì có thể thêm hoặc đề xuất một tuyên bố từ Insights > Community Standards bằng một tài liệu khởi đầu ngắn gọn.
Các tệp sức khỏe cộng đồng của GitHub giúp mọi người hiểu cách một dự án vận hành:
Hướng dẫn đóng góp giải thích cách đề xuất thay đổi
Quy tắc ứng xử đặt ra các kỳ vọng khi tham gia
Chính sách bảo mật giải thích cách báo cáo lỗ hổng
Việc nhận diện ACCESSIBILITY.md mang lại cho thông tin về khả năng tiếp cận một vị trí riêng bên cạnh các hướng dẫn đó.
Các kho lưu trữ mới cũng có sẵn nhãn accessibility cho issue theo mặc định. Tuyên bố giải thích cách báo cáo một rào cản và những gì sẽ diễn ra tiếp theo, trong khi nhãn giúp người bảo trì sắp xếp và theo dõi công việc phát sinh.
Tuyên bố về khả năng tiếp cận giúp các thực hành của dự án trở nên rõ ràng
Chẳng hạn, tuyên bố về khả năng tiếp cận của GitHub CLI ghi lại các thiết lập, rào cản đã biết và cách khắc phục tạm thời. Nó giải thích vì sao đầu ra dạng bảng có thể khó theo dõi bằng trình đọc màn hình và cung cấp một lệnh in số và tiêu đề của pull request, mỗi mục trên một dòng. Nó cũng yêu cầu những người đóng góp thay đổi lời nhắc hoặc đầu ra hiển thị kết quả khi bật các thiết lập tiếp cận liên quan. Nhà phát triển dùng CLI có được cách khắc phục cụ thể; nhà phát triển đóng góp cho CLI có được kỳ vọng rõ ràng về các thay đổi của mình.
Tuyên bố về khả năng tiếp cận của GitHub Annotation Toolkit ghi lại một hạn chế của thư viện Figma: các chú thích dùng vị trí trên canvas, các đường nối và số tương ứng để truyền đạt trực quan các mối quan hệ. Việc truy cập từng đối tượng trên canvas không nhất thiết cho biết các mối quan hệ đó là gì.
Tuyên bố đưa ra cho những người cộng tác một giải pháp thay thế cụ thể: cung cấp mô tả văn bản có cấu trúc, xác định từng phần tử được chú thích, ngữ nghĩa và hành vi dự kiến của nó, cùng thứ tự liên quan nếu có. Với nhà phát triển chuẩn bị hoặc tiếp nhận bàn giao thiết kế, điều này giải thích những thông tin cần đi kèm các chú thích trực quan.
Tệp này cũng giải thích cách báo cáo các rào cản về khả năng tiếp cận và nêu rõ rằng thư viện chưa trải qua kiểm thử chỉ bằng bàn phím hay bằng trình đọc màn hình. Người đọc nhận được cả hướng dẫn thực tế lẫn giới hạn rõ ràng về những gì dự án đã xác minh. Hiển thị thông tin này trên trang tổng quan của kho lưu trữ giúp dễ tìm thấy nó hơn cùng với các tài liệu khác của dự án.

Ghi lại những gì dự án có thể duy trì
Không có một định dạng cố định nào cho tệp ACCESSIBILITY.md. Một thư viện nhỏ, công cụ dòng lệnh, trang tài liệu và ứng dụng web lớn có người dùng, rủi ro và năng lực bảo trì khác nhau. Hãy bắt đầu với thông tin chính xác mà dự án có thể luôn cập nhật.
Ưu tiên và mục tiêu: Giải thích vì sao khả năng tiếp cận quan trọng với dự án và những trải nghiệm người dùng nào được chú trọng.
Kỳ vọng đối với người đóng góp: Mô tả các bước kiểm tra khả năng tiếp cận, bằng chứng hoặc thực hành review được kỳ vọng cho các thay đổi, bao gồm hướng dẫn cho người đóng góp là con người và các coding agent.
Báo cáo rào cản tiếp cận: Cung cấp một kênh báo cáo trực tiếp, dễ tiếp cận. Không yêu cầu tiết lộ tình trạng khuyết tật, ảnh chụp màn hình hay bản ghi hình.
Quy trình phản hồi: Giải thích cách người bảo trì xác nhận, phân loại, theo dõi và trao đổi về các vấn đề tiếp cận. Nếu dự án dùng các mức độ nghiêm trọng, hãy để người bảo trì gán hoặc xác nhận chúng trong quá trình phân loại.
Môi trường được hỗ trợ: Liệt kê các nền tảng, trình duyệt, phương thức nhập liệu và công nghệ hỗ trợ mà dự án hỗ trợ hoặc đã kiểm thử.
Hạn chế đã biết: Mô tả các rào cản dựa trên trải nghiệm bị ảnh hưởng, nêu các giải pháp tạm thời nếu có, và liên kết tới công việc khắc phục đang được theo dõi.
Quyền sở hữu và bảo trì: Nêu tên nhóm, vai trò hoặc người bảo trì chịu trách nhiệm cập nhật bản tuyên bố và các thực hành liên quan.
Phản hồi và cải tiến: Giải thích cách người dùng và người đóng góp có thể đề xuất thay đổi đối với bản tuyên bố hoặc các thực hành về khả năng tiếp cận của dự án.
Lưu ý rằng một dự án có thể nêu một phiên bản và mức của Web Content Accessibility Guidelines làm mục tiêu. Mục tiêu không đồng nghĩa với việc đã được xác minh là tuân thủ. Tuyên bố tuân thủ cần có đánh giá và nên nêu rõ phạm vi được đánh giá, ngày, phương pháp và người đánh giá.
Những tệp ACCESSIBILITY.md hữu ích nhất chứa gì
Các bản tuyên bố về khả năng tiếp cận hữu ích nhất phục vụ những người tìm đến khi sự cố đã xảy ra. Ngôn ngữ đơn giản, liên kết mô tả rõ ràng và lộ trình báo cáo rõ ràng quan trọng hơn ngôn ngữ nặng về pháp lý hoặc tiêu chuẩn.
Hướng dẫn báo cáo hữu ích mời người báo cung cấp bối cảnh liên quan, chẳng hạn tác vụ bị ảnh hưởng, trang, hành vi quan sát được, trình duyệt, hệ điều hành và công nghệ hỗ trợ. Hướng dẫn đó để ảnh chụp màn hình và bản ghi hình là tùy chọn và tránh yêu cầu ai đó chứng minh khuyết tật.
Bản tuyên bố cũng nên đặt ra những kỳ vọng mà người bảo trì có thể đáp ứng nhất quán. Điều đó có thể gồm việc xác nhận đã nhận, cập nhật trạng thái, các giải pháp tạm thời, mốc thời gian dự kiến và cơ hội để người báo cáo xác minh bản sửa.
Bắt đầu từ một ví dụ và điều chỉnh
Open Source Accessibility Toolkit cung cấp một ví dụ công khai chi tiết.
Quy trình Community Standards của GitHub cung cấp một mẫu khởi đầu ngắn hơn với các gợi ý mà dự án có thể thay bằng thông tin của riêng mình. Mục tiêu không phải là tạo ra một chính sách hoàn hảo trước khi đăng tệp. Hãy bắt đầu với thông tin chính xác, nêu rõ những khoảng trống và cập nhật bản tuyên bố khi các thực hành về khả năng tiếp cận của dự án trưởng thành hơn.
Việc thêm bản tuyên bố về khả năng tiếp cận giúp công việc về khả năng tiếp cận dễ được người dùng, người đóng góp và người bảo trì tìm thấy hơn. Phổ biến thực hành này trong các dự án mã nguồn mở giúp khả năng tiếp cận trở thành một phần của cách các cộng đồng lập kế hoạch, xây dựng, báo cáo và cải thiện công việc của họ.
Thêm bản tuyên bố về khả năng tiếp cận vào kho mã của bạn >
Bài viết Accessibility statements now have a home on GitHub xuất hiện đầu tiên trên The GitHub Blog.
Tài liệu nguồn để biên tập: GitHub Blog, tác giả Jan Maarten.
Ngày đăng tại nguồn: 2026-11-05.
- Bản tin
- GitHub Blog

