Skip to content

docs: record the frozen-<version> tags and their selection basis#3044

Merged
znz merged 1 commit into
rurema:masterfrom
znz:salvage/frozen-tags-doc
Jul 9, 2026
Merged

docs: record the frozen-<version> tags and their selection basis#3044
znz merged 1 commit into
rurema:masterfrom
znz:salvage/frozen-tags-doc

Conversation

@znz

@znz znz commented Jul 9, 2026

Copy link
Copy Markdown
Member

概要

旧バージョン凍結 DB の生成に使った doctree コミットへ frozen-<version> タグを打ち(別 push)、docs/OldVersionArchives.md に確定情報を記録します。

タグと選定根拠

version タグ先 根拠
1.8.7 ca77a58 (2016-04-07) Continuation・Precision・Enumerable::Enumerator 削除(2016-04-08)の直前
1.9.3 91f36ea (2017-01-01) YAML::Store の stopdoc 分削除の直前
2.0.0 74001d5 (2017-05-27) 2.0.0 可視記述を削る版分岐整理の直前
2.1.0〜2.3.0 d9b210c (2020-01-08) tk・dl 等の一括削除 8e2af73 の直前
2.4.0〜2.7.0 保存済み db の生成日のコミット 2.7.0 は名前集合の完全一致を検証済み

選定はご指定の方法どおり、ゲート指令(#@since/#@until/#@if)を削除するコミットの履歴洗い出しを主に、DB レベルの名前集合突き合わせで影響を裏取りしました。判明した事実:

  • 「Remove unnecessary version branching」系は大半が最小版未満の死に枝掃除で無害ですが、可視内容を削るものもあります(2.0.0 の 31f2a6c で確認)
  • 本体から削除済みだったメソッドの記述の是正(JSON::State 3件=1.9.2 で削除・Rake 2件・Net::HTTPResponse#to_ary=1.9 で削除・typo 修正)は「削除」とみなさず、アンカーはそれらを越えて後方の修正を取り込みます
  • 最古の Import 群の「generated on 2016-08-28」はコピー日付で、公開アーカイブの実内容はより古い状態から生成されています(アーカイブに 2016-04-08 削除済みの Continuation 等が現存)
  • frozen-* の各時点は現行 bitclust でエラーなくビルドできることを確認済み

push が必要なもの

  • 本 PR のブランチ(docs 変更のみ・CI は走りません)
  • タグ: git push origin 'refs/tags/frozen-*'(この端末に注釈付きタグ作成済み)

🤖 Generated with Claude Code

The July 2026 freeze tagged, for each version from 1.8.7 to 2.7.0, the
doctree commit its frozen database is generated from. For 1.8.7-2.3.0
the anchor is the last master commit that loses nothing from the
version's baseline entry set (next-version-EOL tag, or the published
archive state for 2.3.0), determined by scanning gate-directive
(#@since/#@until/#@if) removals in history and confirming impact at
the database level; post-EOL fixes are thereby included, and removals
of entries for methods that had already been dropped from Ruby itself
(JSON::State, Rake::Application, Net::HTTPResponse#to_ary, a typo) are
treated as corrections, not deletions. For 2.4.0-2.7.0 the tags map
the preserved databases' generation dates (verified exact for 2.7.0 by
a full name-set comparison).

Also note that the 2016-08-28 'generated on' dates of the oldest
archive imports are copy dates -- the published archives were built
from earlier states -- and that all frozen-* anchors build cleanly
with current bitclust.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@znz znz merged commit 18d270b into rurema:master Jul 9, 2026
1 check passed
@znz znz deleted the salvage/frozen-tags-doc branch July 9, 2026 13:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant