ドキュメントの meta description を修正（TDD実践）

[yasulab]

概要

TDD（Test-Driven Development）を実践し、公開ドキュメントの meta description に HTML タグが含まれている問題を修正しました。

TDD アプローチ

🔴 RED

すべての公開ドキュメントの meta description を検証するテストを追加し、問題のあるファイルを検出：

• regional-license.md
• regional-license_en.md
• post-backend-update-history.md

🟢 GREEN

検出された問題を修正し、テストが通ることを確認：

• <div> ラッパーを削除し、<img> タグを1行に統一
• 適切な meta description 用の説明文を追加

🔵 REFACTOR

表記と構造を改善：

• HELLO WORLD Foundation（CoderDojo Foundation の旧名称）への言及を追加
• 言語切り替えリンクの位置を改善
• 説明文の簡潔化

変更内容

テスト追加（spec/models/document_spec.rb）

describe 'meta descriptions' do
  it 'すべての公開ドキュメントの meta description に HTML タグが含まれていないこと' do
    # 全ドキュメントをチェックし、HTML タグが含まれている場合はエラー
  end
end

修正したファイル

1. regional-license.md

• Before: <img> タグが description に（HTMLタグとして認識）
• After: 「CoderDojo Foundation (当時の名称: HELLO WORLD Foundation) と一般社団法人 CoderDojo Japan の間で締結された地域ライセンス契約書です。2016年の契約当時の写しとなります。」

2. regional-license_en.md

• Before: <img> タグが description に（HTMLタグとして認識）
• After: 「Regional license agreement between CoderDojo Foundation and CoderDojo Japan Association, dated August 27th, 2016.」

3. post-backend-update-history.md

• Before: description が空
• After: 「2016年の CoderDojo Advent Calendar で公開した、coderdojo.jp のバックエンド刷新に関する技術記事です。」

4. teikan.md

• 説明文を簡潔化（regional-license との表記を統一）

テスト結果

bundle exec rspec spec/models/document_spec.rb
8 examples, 0 failures ✅

効果

• ✅ SNS シェア時に適切な meta description が表示される
• ✅ HTML タグではなく意味のある説明文が表示される
• ✅ 将来的な meta description の品質を自動テストで保証

スクリーンショット

meta description の例：

• 日本語版: 「CoderDojo Foundation (当時の名称: HELLO WORLD Foundation) と一般社団法人 CoderDojo Japan の間で締結された地域ライセンス契約書です。」
• 英語版: 「Regional license agreement between CoderDojo Foundation and CoderDojo Japan Association, dated August 27th, 2016.」

関連 PR

• 英語版定款ページ (/teikan_en) を追加 #1796 - 英語版定款ページの追加（同様の meta description 改善を実施）