製品情報の報告と編集¶

製品情報の誤りや未収録製品は、GitHubのフォームから報告できます。 JSONを編集できる場合は、調査結果データと収録製品データを直接修正し、Pull Requestを送ることもできます。

製品情報を報告する¶

製品の追加と修正フォームでは、次の内容を入力します。

1. 報告の種類
2. レンズと関連光学製品、マウントアダプターのどちらに関する報告か
3. 製品名
4. 現在の情報と、気づいた誤りや不足
5. 分かれば、メーカーまたはブランドの公式製品ページ、仕様書、マニュアルなどのURL
6. ページ内の確認箇所、地域差、画像などの補足

フォームでは、「誤りの修正」「未収録製品」「収録対象外かもしれない」「公式URLの変更」「その他」から報告の種類を選びます。 どのデータセットに該当するか分からない場合は、フォームで「不明」を選択できます。

AIを使って報告文を整えても構いません。 ただし、URL、製品名、数値などの事実は推測させず、確認できた内容だけを投稿してください。

不具合を報告する¶

リポジトリ検証、配布データの生成、JSON Schemaに関する不具合は、不具合報告フォームを使用してください。 ドキュメントサイトやCIの不具合も、同じフォームから報告できます。 製品情報の誤りや未収録製品は、前節の製品情報用フォームから報告します。

ファイルを直接編集する¶

直接編集する場合は、次の表から変更内容に対応するファイルを選んで修正します。 配布データと製品一覧は自動生成されるため、直接編集しません。

調査結果データと収録製品データ¶

候補製品を調べた結果は、製品ごとに一つの調査結果データへ記録します。 収録（included）と判断した製品には、対応する収録製品データが必要です。 除外（excluded）または要確認（needs-review）では、収録製品データを作成しません。

収録判断、情報源、reviewedOn、unresolvedの記録方法は調査結果データで説明しています。 収録範囲は収録範囲と考え方を確認してください。

製品情報を記録する¶

正式な製品名と、根拠となる情報源で確認できた値をそのまま記録します。 情報源で確認できない値を推測したり、矛盾する複数の値から一つを独断で選んだりしません。

項目の省略、null、空配列、falseの使い分けは値の読み方に従います。 各項目の意味は、レンズと関連光学製品のフィールドリファレンスまたはマウントアダプターのフィールドリファレンスで確認できます。 正確な型、必須項目、許可される値はJSON Schemaリファレンスを参照してください。

最終確認日とデータバージョン¶

調査結果データの最終確認日（reviewedOn）には、判断と情報源を実際に確認した日を記録します。 checkedを変更しただけでは、reviewedOnを更新しません。 収録製品データの確定値またはcheckedの対象を変更する場合は、関係する情報源を再確認し、現在の判断と情報源を実際に確認した日を記録します。 reviewedOnが現在のdataVersionより後になる場合は、Pull Requestでの検証のため、config/versions.jsonのdataVersionを最新のreviewedOnと同じ日付へ暫定的に更新します。 公開版のdataVersionには、リリース日（Asia/Tokyo）を使用します。

変更を検証する¶

Python 3.14以降とHatchが必要です。 環境の準備は開発と検証を参照してください。

次の順序で、JSONの整形、配布データの生成、リポジトリ検証、ドキュメントのビルドを実行します。

hatch run format-json
hatch run generate
git diff -- dist PRODUCTS.md
hatch run check
hatch run docs:build

生成後は、意図した変更が生成ファイルへ反映されていることを確認します。 調査結果データだけの変更ではPRODUCTS.md、レンズの収録製品データ変更ではレンズFull版、Light版、PRODUCTS.md、マウントアダプターの収録製品データ変更ではマウントアダプターFull版とPRODUCTS.mdに差分が生じる場合があります。 実際に差分がある生成ファイルだけを、その変更元となった調査結果データ、収録製品データ、またはレジストリと同じPull Requestへ含めます。

ドキュメントを変更する場合は、対応する日本語版と英語版を同じPull Requestで更新します。 各文書の基準版と検証方法は、ドキュメントの保守を参照してください。

Pull Requestを送る¶

Pull Requestには、次の内容を記載します。

1. 変更した内容と理由
2. 確認に使った情報源のURL
3. 残っている未解決事項
4. 実行した検証

調査結果データ、収録製品データ、レジストリへの貢献にはCC BY 4.0が適用されます。 コード、JSON Schema、テスト、ツール、設定、ドキュメントへの貢献にはMIT Licenseが適用されます。 貢献者自身が、該当するプロジェクトのライセンスで提供する権限を持つ内容だけを提出してください。 第三者の文章、画像、ロゴなどを含める場合は、権利者、出典、利用条件、許諾の対象外となる部分をPull RequestまたはIssueに明記してください。 Issueに調査資料として添付した画像などは、そのまま公開文書へ転載しません。 詳しい適用範囲はライセンスを確認してください。

関連ページ¶

• 調査結果データ：収録判断、情報源、未解決事項の記録方法
• 収録範囲と考え方：レンズと関連光学製品、マウントアダプターの収録基準
• 値の読み方：項目の省略、null、空配列、falseの意味
• データモデル：調査結果データ、収録製品データ、配布データの関係
• 開発と検証：開発環境、生成、検証の詳細