Sync markdown migration docs with the completed old-version salvage#206
Merged
Merged
Conversation
The July 2026 old-version salvage (bitclust rurema#203, doctree #3042) regenerated manual/api with --scope 1.8.7,4.2, growing the tree from 1245 to 1250 files (api 1161 -> 1166). Update the file and roundtrip counts in the announcement, proposal and operations guides, and move the salvage out of the "future work" list. announcement phase 4 now records the salvage as done, and distinguishes its two paths so it does not overclaim: - What goes into manual/: the wide-scope re-conversion only recovers the below-3.0 version gates that HEAD's refm still retains, so manual/ can build every rake target version. Content already pruned from HEAD's refm is NOT reintroduced into manual/. - What stays out of manual/: substantially divergent old versions (1.8.7, etc.) are kept as separate frozen databases pinned by the frozen-<version> tags (1.8.7-2.7.0) and surfaced only in the site search, not merged into master. operations: bridge removal is now gated only on the findings follow-up, since the salvage is complete. The dated verification record in markdown-findings.md (roundtrip 1245/1245 as of 2026-07-07) is left as-is; it is correct for its date. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
概要
2026-07 の旧バージョンサルベージ（bitclust #203 / rurema/doctree#3042）がマージされた後の現状に合わせて、Markdown 移行の3文書の数値・ステータスを更新します（ドキュメントのみ、コード変更なし）。
サルベージで
manual/apiを--scope 1.8.7,4.2で再生成した結果、manual/のファイル数が 1245 → 1250（api 1161 → 1166） に増えましたが、紹介・提案・運用の各ドキュメントがサルベージ前の数値のまま残っていました。あわせて、announcement がサルベージを「将来の残タスク」として列挙していた点を「完了」に更新します。変更内容
doc/markdown-announcement.md
1245 → 1250に更新manual/に入るもの:--scope 1.8.7,4.2の再変換は、HEAD のrefm/にまだ残っている <3.0 のゲートを取りこぼさず含めるだけ（1161 → 1166 ファイル、rake の全対象版がビルド可能に）。HEAD から削除済みの旧版固有記述はmanual/には入れないmanual/に混ぜないもの: 1.8.7 など大きく分岐した古い版は、frozen-<version>タグ（1.8.7〜2.7.0）で固定した凍結 DB として検索にのみ載せる。復元用の対応表として doctree のdocs/OldVersionArchives.mdへリンクrefm/削除・bitclust 非依存パイプライン）をフェーズ5へdoc/markdown-proposal.md
1245 → 1250に更新doc/markdown-operations.md
api 1161/1161 → 1166/1166に更新補足
doc/markdown-findings.mdの「roundtrip 1245/1245（2026-07-07 時点）」は、その日付での検証記録として正しいので変更していません。🤖 Generated with Claude Code