GitHub chính thức hỗ trợ tệp ACCESSIBILITY.md để chuẩn hóa khả năng truy cập dự án

Việc duy trì khả năng truy cập (accessibility) trong các dự án phần mềm thường bị phân tán ở nhiều nơi như issue tracker, hướng dẫn đóng góp, báo cáo kiểm định hoặc các cuộc hội thoại rời rạc. Điều này gây khó khăn cho người dùng khi gặp rào cản, đồng thời khiến các maintainer mất đi thông tin quan trọng khi dự án thay đổi nhân sự.

Để giải quyết vấn đề này, GitHub đã chính thức hỗ trợ tệp ACCESSIBILITY.md. Tệp này sẽ hiển thị trực tiếp trên trang tổng quan của repository, cung cấp một vị trí cố định để dự án công bố các mục tiêu, kỳ vọng đối với người đóng góp, môi trường hỗ trợ, các hạn chế đã biết và quy trình báo cáo lỗi.

Cách GitHub giúp thông tin accessibility trở nên dễ tìm kiếm

GitHub hiện đã nhận diện tệp ACCESSIBILITY.md nếu được đặt tại thư mục gốc, thư mục .github/ hoặc docs/. Đối với các repository công khai, các maintainer có thể dễ dàng thêm hoặc đề xuất một bản tuyên bố thông qua mục Insights > Community Standards với các mẫu có sẵn.

Việc đưa ACCESSIBILITY.md vào hệ thống tệp tin sức khỏe cộng đồng giúp nó đứng ngang hàng với các tài liệu quan trọng khác như hướng dẫn đóng góp (contribution guidelines), bộ quy tắc ứng xử (code of conduct) và chính sách bảo mật (security policies). Ngoài ra, các repository mới giờ đây cũng được mặc định thêm nhãn accessibility để giúp các maintainer phân loại và theo dõi các vấn đề liên quan hiệu quả hơn.

Nội dung cốt lõi của một tệp ACCESSIBILITY.md hữu ích

Không có định dạng cố định cho tệp này, tùy thuộc vào quy mô và mục tiêu của từng dự án. Tuy nhiên, một tài liệu đầy đủ nên bao gồm:

• Mục tiêu và ưu tiên: Tại sao accessibility quan trọng với dự án và trải nghiệm người dùng nào được ưu tiên.
• Kỳ vọng đối với người đóng góp: Các quy trình kiểm tra hoặc tiêu chuẩn cần tuân thủ khi gửi pull request.
• Quy trình báo cáo: Hướng dẫn báo cáo rào cản một cách trực tiếp, không yêu cầu người dùng phải tiết lộ thông tin cá nhân nhạy cảm.
• Môi trường hỗ trợ: Danh sách các nền tảng, trình duyệt và công nghệ hỗ trợ đã được kiểm thử.
• Hạn chế đã biết: Mô tả các rào cản hiện tại, các giải pháp tạm thời (workaround) và liên kết đến các công việc đang được khắc phục.
• Quyền sở hữu và bảo trì: Đội ngũ hoặc cá nhân chịu trách nhiệm cập nhật tài liệu này.

GitHub khuyến khích các dự án bắt đầu với những thông tin chính xác nhất mà họ có thể duy trì, thay vì cố gắng tạo ra một chính sách hoàn hảo ngay từ đầu. Việc công khai hóa các thông tin này không chỉ giúp người dùng dễ dàng tiếp cận dự án mà còn giúp cộng đồng nguồn mở xây dựng văn hóa phát triển phần mềm hòa nhập và bền vững hơn.

Nguồn tham khảo: GitHub Blog