MF Blogs 便利ツール
暗い背景にチェックリストが並ぶウィンドウがあり、その手前に青紫の円の中で両手を広げた人のアクセシビリティのアイコンと緑のラベルのタグが描かれたイラスト

記事

GitHub、ACCESSIBILITY.mdをリポジトリ画面に表示——アクセシビリティ方針を書く8つの項目も提示

GitHubがリポジトリのトップ画面でACCESSIBILITY.mdを認識・表示するようになりました。Community Standardsからひな形を追加でき、新規リポジトリには「accessibility」ラベルが標準で付きます。GitHubは記載すべき8つの項目も示しています。

0:00 0:00

GitHubは2026年11月5日、リポジトリのトップ画面でACCESSIBILITY.mdファイルを表示する機能を公開しました。READMEやライセンスと同じように専用のタブとサイドバーのリンクが表示され、プロジェクトのアクセシビリティ方針、既知の問題、サポート環境、問題の報告方法などを1か所にまとめられます。あわせて、新しく作ったリポジトリにはaccessibilityラベルが標準で用意されるようになりました。

アクセシビリティの情報に「決まった置き場所」を作る

GitHubは、アクセシビリティに関する情報がIssue、コントリビューションガイド、監査レポート、メンバーの頭の中、ユーザーとのやり取りなどに散らばりがちだと指摘しています。置き場所が決まっていないと、問題にぶつかった人は情報を探し回ることになり、メンテナーもメンバーやオーナーが入れ替わるたびに経緯を失ってしまいます。

ACCESSIBILITY.mdはこの問題に対する答えで、プロジェクトの目標、コントリビューターへの期待、サポートする環境、既知の制約、問題を報告する手順をまとめて書いておく場所です。GitHub Docsで案内されているコミュニティヘルスファイル、つまりコントリビューションガイドや行動規範、セキュリティポリシーと並ぶ位置付けになります。

GitHubのリポジトリ概要画面で、READMEの横に「Accessibility」タブ、右側のサイドバーにAccessibilityへのリンクが表示されている画面

画像引用元: GitHub Blog

ファイルの置き場所とひな形の追加方法

GitHubが認識するのは、リポジトリのルート、.github/ディレクトリ、docs/ディレクトリのいずれかに置いたACCESSIBILITY.mdです。Organizationの.githubリポジトリに置いた方針を、配下のリポジトリが引き継ぐこともできます。

公開リポジトリでは、「Insights」→「Community Standards」から簡潔なひな形を使ってファイルを追加したり、追加を提案したりできます。ひな形には、優先事項やコントリビューターへの期待、問題の報告方法といった見出しと記入のヒントが入っており、自分のプロジェクトの情報に書き換えて使う形です。新規リポジトリに標準で付くaccessibilityラベルは、報告された問題を整理・追跡するためのもので、方針の文書とラベルを組み合わせて運用することを想定しています。

GitHubのInsightsにあるCommunity Standardsのページで、Accessibilityの項目に追加ボタンが表示されている画面

画像引用元: GitHub Blog

GitHub CLIとAnnotation Toolkitの記載例

GitHubは自社プロジェクトの例も紹介しています。GitHub CLIの方針では、表形式の出力はスクリーンリーダーで追いにくいことを既知の問題として挙げ、代わりにプルリクエストの番号とタイトルを1行ずつ出力するコマンドを案内しています。プロンプトや出力を変更するコントリビューターには、アクセシビリティ関連の設定を有効にした状態の結果を示すよう求めています。

デザイン向けのGitHub Annotation Toolkitでは、Figma上の注釈が位置や線、番号といった見た目で関係を表しているため、支援技術では関係が伝わらない場合があると明記しています。そのうえで、各要素の意味や振る舞い、順序をテキストで説明するという代替策を示し、キーボードのみやスクリーンリーダーでの検証はまだ行っていないことも書いています。

記載すべき8つの項目

GitHubは決まった書式はないとしつつ、プロジェクトが維持できる範囲で正確な情報から始めるよう勧め、次の項目を挙げています。

項目書く内容
優先事項と目標なぜアクセシビリティが重要か、どの体験に注力するか
コントリビューターへの期待変更時に求めるチェックや証跡。人間とコーディングエージェントの双方向け
問題の報告方法直接たどれる報告経路。障害の申告やスクリーンショットを必須にしない
対応プロセス受け付け、トリアージ、追跡、連絡の流れ
サポート環境対応・検証済みのプラットフォーム、ブラウザ、入力方法、支援技術
既知の制約影響を受ける体験、回避策、修正作業へのリンク
担当と保守方針を最新に保つチームや担当者
フィードバック方針や取り組みへの改善提案の受け付け方

また、WCAGのバージョンとレベルを目標として書くことはできても、それは適合を保証するものではないと注意しています。適合をうたうには評価が必要で、対象範囲、日付、方法、評価者を明記すべきだとしています。

自分のリポジトリでまず書くこと

GitHubは、最も役に立つ方針は「すでに問題が起きた後に訪れる人」に向けたものだと述べています。法律や規格の用語を並べるより、平易な言葉、内容が分かるリンク、はっきりした報告経路のほうが大切だという考え方です。報告では、作業内容やページ、起きた現象、ブラウザ、OS、支援技術といった情報を書いてもらうよう促しつつ、スクリーンショットや録画は任意にし、障害の証明を求めないことを推奨しています。

詳しい例としてはOpen Source Accessibility Toolkitの方針が紹介されています。完璧な文書を用意してから公開する必要はなく、正確な情報と分かっていない点を書いて、取り組みの成熟に合わせて更新していけばよいというのがGitHubの立場です。OSSを運営している人は、まずaccessibilityラベルが付いた既存のIssueを洗い出し、「既知の制約」の欄を埋めるところから始めると書きやすいでしょう。