Skip to content

Update announcement/proposal docs: migration completed and live#200

Merged
znz merged 1 commit into
rurema:masterfrom
znz:docs/markdown-migration-status
Jul 9, 2026
Merged

Update announcement/proposal docs: migration completed and live#200
znz merged 1 commit into
rurema:masterfrom
znz:docs/markdown-migration-status

Conversation

@znz

@znz znz commented Jul 9, 2026

Copy link
Copy Markdown
Member

概要

Markdown 移行が完了して本番稼働中である現状に合わせて、紹介・提案の2文書を更新します(ドキュメントのみ、コード変更なし)。

2026年7月に #189(bitclust ネイティブ対応)・rurema/doctree#3035(manual/ ツリー + Rakefile 切替)・generated-documents の切替がすべてマージされ、docs.ruby-lang.org/ja/ は doctree の manual/(Markdown)からビルドした HTML を配信しています。編集リンクも manual/ の .md を指します。

変更内容

doc/markdown-announcement.md

  • 冒頭に「編集場所が変わりました」のお知らせを追加(編集は manual/ へ、refm/ は凍結
  • フェーズ 3(Markdown での執筆開始)を「提案中」→「完了・本番切替済み」に
  • フェーズ 4 に残タスクを明記: gem リリース(refe2 等向け)・旧バージョン(< 3.0)サルベージ・refm/ 削除
  • FAQ「貢献するには」を移行後のワークフロー(manual/ を編集して PR)に書き換え

doc/markdown-proposal.md

  • 冒頭にステータスバナーを追加(提案は採用され移行完了。設計判断の記録として維持し、現在の案内は announcement / operations へ誘導)
  • 「現在の進捗」を「進捗(移行完了)」に更新(doctree マージ済み・本番配信中を追記)
  • レビュー前提の文言(「提案」「現行」等)を移行後の表現に調整

🤖 Generated with Claude Code

The Markdown migration shipped in July 2026: bitclust rurema#189, doctree #3035,
and the generated-documents switch are all merged, and docs.ruby-lang.org/ja/
now serves HTML built from the doctree manual/ tree.

Update the two outreach documents to reflect this:
- announcement: add a notice that editing now happens in manual/ (refm/ is
  frozen), mark phase 3 as completed, list remaining phase 4 tasks
  (gem release, pre-3.0 salvage, refm/ removal), and rewrite the
  contribution FAQ for the post-migration workflow
- proposal: add a status banner marking the proposal as adopted and
  completed, and reword review-phase phrasing accordingly

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@znz znz merged commit 0dd0aef into rurema:master Jul 9, 2026
9 checks passed
@znz znz deleted the docs/markdown-migration-status branch July 9, 2026 02:37
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