Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[Phase 16] S16 — Documentation source-of-truth and localization governance

オープン
  • 何か問題がありますか？
#902 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
15/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
活発
技術スタック
markdown, python
領域
documentation, release, tooling

調査の方向性

This is an umbrella roadmap step, so pick one exit criterion rather than the whole issue. Start with check_release_record_sync.py and check_bilingual_parity.py in the repo, plus docs/roadmap.md and docs/README.md, and read the linked phase-16 roadmap section first. Done means one listed exit criterion passes its guard, with the Turkish mirror updated in the same commit.

索引モデルが issue の本文から書いたものです。

説明

phase: 16 source: roadmap

Roadmap · Phase 16, step S16 · size M · 5 unit(s) · planned in docs/roadmap/phase-16-trust-surface-hardening.md:797-822

Summary

Hand-maintained restatements of facts that have a canonical source — the release version, the locale key count, the wheel version, the config schema, the docs taxonomy. Every fix is the same move: derive or register, then ratchet. Deliberately last: it ratchets the parity guards to --strict, which must not run ahead of S15's large bilingual edits.

Units

Unit Tracked by (October 2026 review)
C31-LOCALIZATION-GOV (= DOCS-10 + DOCS-18) #636 · #670 · #732 · #751 · #778 · #797 · #810
F-W20260729-DOCS-11 #580 · #732
F-W20260729-DOCS-12 #606 · #778
F-W20260729-DOCS-13, F-W20260729-DOCS-17 #621 · #667 · #703 · #793 · #796

Plan

  • Extend check_release_record_sync.py to the roadmap current-state lines and the strategy restatements; add table/list-row parity to the bilingual guard.
  • Optional, low priority: a statement of what site/ is and what a claim on it must be backed by, and an index for docs/usermanuals/ (link discipline, bilingual duty, schema-drift gate, build step, its own workflow, json-output.md as a MAJOR-locked contract).

Exit criteria

  • localization.md's locale-status section matches check_site_chrome_parity.py --strict output, and CI runs that guard with --strict.
  • check_bilingual_parity.py --strict covers docs/product_strategy.md and fails when a mirror drops a table row or list item inside a matched section.
  • docs/roadmap.md and its Turkish mirror name exactly one latest release in the headline, the current-state sentence, the status table, the mermaid graph and the documentation map.
  • Every notebook version literal derives from one constant, and the pin guard fails when a downloaded artifact tag differs from the wheel pin.
  • docs/README.md exists, matches documentation.md's directory rules, is reachable from the pyproject.toml Documentation URL, and labels canonical versus archival surfaces.

How to deliver

  • One root-cause family, committed on its own; then an Opus review round and a Sonnet review round, each with verified findings fixed and committed before the next step begins.
  • A reproducer that is red before the fix and green after; the full gauntlet from CLAUDE.md passes under ./.venv/bin/python.
  • Every English documentation edit ships with its Turkish mirror in the same commit; a new or renamed audit event gets its EN and TR catalog rows in the same PR.
  • A step that grows a deferred module carries its budget_history justification in the same diff; a widened guard rolls out non-strict first, then flips.
  • Commit bodies cite Absorbs F-W20260729-…; the CHANGELOG [Unreleased] section gets an entry only for a change a user or library consumer can observe (decision C-20).

Planned in docs/roadmap/phase-16-trust-surface-hardening.md (read at f94595f). Unit IDs (F-W20260729-…) come from the 2026-07-29/30 full-project review; the issue numbers next to them are the October 2026 review's records of the same defects.

主要言語
Python
スター
9
フォーク
1
平均マージ
4時間 3分
マージ済み PR（30日）
3

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

HodeTech/ForgeLM のほかの issue

HodeTech/ForgeLM の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。