Prepare documentation site for public launch (#7)

* docs: update landing page Quick Start to match docs workflow

- Change step 1: Install → Initialize project (gem install + trc --init)
- Change step 2: Create file → Start watch mode (trc --watch)
- Change step 3: Compile → Write typed Ruby (src/hello.trb)
- Update i18n translations for ko and ja

* refactor: update tagline to TypeScript-style "Ruby with syntax for types"

- Change hero title from "Type-safe Ruby, the TypeScript way" to
  "T-Ruby is Ruby with syntax for types."
- Update subtitle to mention .rbs output and "Just like TypeScript"
- Update all i18n translations (ko, ja)

* docs: rename first-trb-file to understanding-trb-files

Change document title and filename across all languages:
- EN: "Your First .trb File" → "Understanding .trb Files"
- KO: "첫 번째 .trb 파일" → ".trb 파일 이해하기"
- JA: "最初の.trbファイル" → ".trbファイルを理解する"

* feat: redesign homepage with new sections and i18n

- Add "What is T-Ruby?" section with 3-column layout
- Redesign code showcase with arrow-based transformation flow
- Add "Existing Methods" comparison section (Sorbet, RBS, TypeProf, Others)
- Add "Join the Journey" GitHub contribution section
- Add version banner with changelog link
- Add JetBrains to editors list
- Update footer copyright with linked author names
- Add Japanese and Korean translations for new sections

* feat: add experimental notice to contribute section and footer credits

Author: yhk1038

docs/getting-started/installation.md

@@ -153,5 +153,5 @@ sudo dnf groupinstall "Development Tools"
 Now that T-Ruby is installed, let's write some code:
 
 - [Quick Start](/docs/getting-started/quick-start) - Get running in 5 minutes
-- [Your First .trb File](/docs/getting-started/first-trb-file) - A detailed walkthrough
+- [Understanding .trb Files](/docs/getting-started/understanding-trb-files) - A detailed walkthrough
 - [Editor Setup](/docs/getting-started/editor-setup) - Configure your IDE

docs/getting-started/quick-start.md

@@ -142,7 +142,7 @@ Here's a summary of the commands you'll use most:
 
 You've written and compiled your first T-Ruby code! Here's where to go next:
 
-1. **[Your First .trb File](/docs/getting-started/first-trb-file)** - A deeper dive into T-Ruby files
+1. **[Understanding .trb Files](/docs/getting-started/understanding-trb-files)** - A deeper dive into T-Ruby files
 2. **[Editor Setup](/docs/getting-started/editor-setup)** - Get syntax highlighting and autocomplete
 3. **[Basic Types](/docs/learn/basics/basic-types)** - Learn the type system
 

docs/getting-started/first-trb-file.md …tting-started/understanding-trb-files.mddocs/getting-started/first-trb-file.md renamed to docs/getting-started/understanding-trb-files.md docs/getting-started/first-trb-file.md renamed to docs/getting-started/understanding-trb-files.md

@@ -1,13 +1,13 @@
 ---
 sidebar_position: 3
-title: Your First .trb File
-description: Create and compile your first T-Ruby file
+title: Understanding .trb Files
+description: Learn how T-Ruby files work
 ---
 
 <DocsBadge />
 
 
-# Your First .trb File
+# Understanding .trb Files
 
 This guide takes you through creating a T-Ruby file step by step, explaining each concept as we go.
 

docusaurus.config.ts

@@ -4,7 +4,7 @@ import type * as Preset from '@docusaurus/preset-classic';
 
 const config: Config = {
   title: 'T-Ruby',
-  tagline: 'Type-safe Ruby, the TypeScript way',
+  tagline: 'Ruby with syntax for types.',
   favicon: 'img/logo.svg',
 
   future: {
@@ -199,7 +199,7 @@ const config: Config = {
           ],
         },
       ],
-      copyright: `Copyright © ${new Date().getFullYear()} T-Ruby. Built with Docusaurus.`,
+      copyright: `Copyright © ${new Date().getFullYear()} <a href="https://github.com/yhk1038" target="_blank" rel="noopener noreferrer">Fred</a> & <a href="https://github.com/type-ruby" target="_blank" rel="noopener noreferrer">T-Ruby</a>. Built with <a href="https://docusaurus.io" target="_blank" rel="noopener noreferrer">Docusaurus</a>.`,
     },
     prism: {
       theme: prismThemes.github,

i18n/ja/code.json

@@ -212,13 +212,29 @@
     "description": "Hero title line 1"
   },
   "homepage.hero.titleHighlight": {
-    "message": "TypeScriptの方法で",
-    "description": "Hero title line 2 highlighted"
+    "message": "型構文を持つRubyです。",
+    "description": "Hero title highlighted text"
   },
   "homepage.hero.subtitle2": {
-    "message": "型アノテーション付きの.trbファイルを書きましょう。ランタイムオーバーヘッドなしで標準の.rbファイルにコンパイルします。",
+    "message": "型アノテーション付きの.trbファイルを書きましょう。<br />標準の.rbファイルと.rbsにコンパイルします。<br />TypeScriptのように。",
     "description": "Hero subtitle"
   },
+  "homepage.hero.versionNotice": {
+    "message": "T-Ruby {version} が利用可能です",
+    "description": "Version notice with version number"
+  },
+  "homepage.whatIs.rubyMore.description": {
+    "message": "T-Rubyは追加の構文でRubyを強力に拡張します。<strong>これは静的型だけでなくコンパイルタイムを意味します。</strong>",
+    "description": "Ruby and More description"
+  },
+  "homepage.whatIs.trust.description": {
+    "message": "T-RubyコードはRubyとRBSに変換されるため、<strong>Ruby、RBSが動作するすべてのエコシステムでの動作を保証します。</strong>",
+    "description": "A Result You Can Trust description"
+  },
+  "homepage.whatIs.scale.description": {
+    "message": "T-Rubyを通じてRubyで作成された製品の型安全性を確保しましょう。<strong>大規模でも安全な状態を維持できます。</strong>",
+    "description": "Safety at Scale description"
+  },
   "homepage.install.command": {
     "message": "gem install t-ruby",
     "description": "Install command"
@@ -264,7 +280,7 @@
     "description": "Feature description"
   },
   "homepage.codeShowcase.title": {
-    "message": "実際の動作を見る",
+    "message": "例",
     "description": "Code showcase title"
   },
   "homepage.codeShowcase.subtitle": {
@@ -292,15 +308,15 @@
     "description": "Quick start title"
   },
   "homepage.quickStart.step1.title": {
-    "message": "T-Rubyをインストール",
+    "message": "プロジェクトを初期化",
     "description": "Step 1 title"
   },
   "homepage.quickStart.step2.title": {
-    "message": ".trbファイルを作成",
+    "message": "ウォッチモードを開始",
     "description": "Step 2 title"
   },
   "homepage.quickStart.step3.title": {
-    "message": "コンパイルして実行",
+    "message": "型付きRubyを書く",
     "description": "Step 3 title"
   },
   "homepage.quickStart.cta": {
@@ -323,6 +339,10 @@
     "message": "VS Code拡張機能",
     "description": "VS Code extension"
   },
+  "homepage.tooling.editors.jetbrains": {
+    "message": "JetBrainsプラグイン",
+    "description": "JetBrains plugin"
+  },
   "homepage.tooling.editors.neovim": {
     "message": "Neovimプラグイン",
     "description": "Neovim plugin"
@@ -363,6 +383,66 @@
     "message": "すべてのgemが動作",
     "description": "All gems work"
   },
+  "homepage.existingMethods.title": {
+    "message": "既存の方法",
+    "description": "Existing methods section title"
+  },
+  "homepage.existingMethods.subtitle": {
+    "message": "既存のRuby型付けソリューションと比較して、T-Rubyの違いを確認してください。",
+    "description": "Existing methods section subtitle"
+  },
+  "homepage.existingMethods.howToUse": {
+    "message": "使い方",
+    "description": "How to use label"
+  },
+  "homepage.existingMethods.limitations": {
+    "message": "制限事項",
+    "description": "Limitations label"
+  },
+  "homepage.existingMethods.vsTRuby": {
+    "message": "T-Rubyのアプローチ",
+    "description": "T-Ruby approach label"
+  },
+  "homepage.contribute.title": {
+    "message": "一緒に作りましょう",
+    "description": "Contribute section title"
+  },
+  "homepage.contribute.subtitle": {
+    "message": "T-Rubyはオープンソースプロジェクトです。あなたの参加が大きな力になります。",
+    "description": "Contribute section subtitle"
+  },
+  "homepage.contribute.experimental": {
+    "message": "まだ実験段階です。コアコンパイラは動作しますが、改善すべき点がたくさんあります。",
+    "description": "Experimental stage notice"
+  },
+  "homepage.contribute.feedback": {
+    "message": "フィードバックや提案はいつでも歓迎します！",
+    "description": "Feedback welcome notice"
+  },
+  "homepage.contribute.star.title": {
+    "message": "GitHubでStarする",
+    "description": "Star card title"
+  },
+  "homepage.contribute.star.description": {
+    "message": "応援してくださり、より多くの方がT-Rubyを見つけられるようにしてください",
+    "description": "Star card description"
+  },
+  "homepage.contribute.issue.title": {
+    "message": "Issue報告",
+    "description": "Issue card title"
+  },
+  "homepage.contribute.issue.description": {
+    "message": "バグを発見しましたか？新機能を提案したいですか？お知らせください",
+    "description": "Issue card description"
+  },
+  "homepage.contribute.pr.title": {
+    "message": "コード貢献",
+    "description": "PR card title"
+  },
+  "homepage.contribute.pr.description": {
+    "message": "プルリクエストを送って、型安全なRubyの未来を一緒に作りましょう",
+    "description": "PR card description"
+  },
   "homepage.layout.title": {
     "message": "型安全なRuby",
     "description": "Layout title"

i18n/ja/docusaurus-plugin-content-docs/current/getting-started/installation.md

@@ -153,5 +153,5 @@ sudo dnf groupinstall "Development Tools"
 T-Rubyがインストールされたので、コードを書いてみましょう：
 
 - [クイックスタート](/docs/getting-started/quick-start) - 5分で始める
-- [最初の.trbファイル](/docs/getting-started/first-trb-file) - 詳細なガイド
+- [.trbファイルを理解する](/docs/getting-started/understanding-trb-files) - 詳細なガイド
 - [エディタ設定](/docs/getting-started/editor-setup) - IDEの設定

i18n/ja/docusaurus-plugin-content-docs/current/getting-started/quick-start.md

@@ -149,6 +149,6 @@ end
 
 おめでとうございます！T-Rubyの基本を学びました。さらに詳しく学ぶには：
 
-- [最初の.trbファイル](/docs/getting-started/first-trb-file) - 詳細な最初のファイルガイド
+- [.trbファイルを理解する](/docs/getting-started/understanding-trb-files) - 詳細な最初のファイルガイド
 - [エディタ設定](/docs/getting-started/editor-setup) - VS Codeなどのエディタ設定
 - [基本構文](/docs/learn/basics/type-annotations) - T-Ruby構文を詳しく学ぶ

…urrent/getting-started/first-trb-file.md …tting-started/understanding-trb-files.mdi18n/ja/docusaurus-plugin-content-docs/current/getting-started/first-trb-file.md renamed to i18n/ja/docusaurus-plugin-content-docs/current/getting-started/understanding-trb-files.md i18n/ja/docusaurus-plugin-content-docs/current/getting-started/first-trb-file.md renamed to i18n/ja/docusaurus-plugin-content-docs/current/getting-started/understanding-trb-files.md

@@ -1,13 +1,13 @@
 ---
 sidebar_position: 3
-title: 最初の.trbファイル
-description: 最初のT-Rubyファイルの作成とコンパイル
+title: .trbファイルを理解する
+description: T-Rubyファイルの仕組みを学ぶ
 ---
 
 <DocsBadge />
 
 
-# 最初の.trbファイル
+# .trbファイルを理解する
 
 このガイドでは、T-Rubyファイルをステップバイステップで作成しながら、各概念を説明します。
 

i18n/ko/code.json

@@ -212,13 +212,29 @@
     "description": "Hero title line 1"
   },
   "homepage.hero.titleHighlight": {
-    "message": "TypeScript 방식으로",
-    "description": "Hero title line 2 highlighted"
+    "message": "타입 문법을 갖춘 Ruby입니다.",
+    "description": "Hero title highlighted text"
   },
   "homepage.hero.subtitle2": {
-    "message": "타입 어노테이션이 있는 .trb 파일을 작성하세요. 런타임 오버헤드 없이 표준 .rb 파일로 컴파일됩니다.",
+    "message": "타입 어노테이션이 있는 .trb 파일을 작성하세요.<br />표준 .rb 파일과 .rbs로 컴파일됩니다.<br />타입스크립트처럼요.",
     "description": "Hero subtitle"
   },
+  "homepage.hero.versionNotice": {
+    "message": "T-Ruby {version} 현재 사용 가능합니다",
+    "description": "Version notice with version number"
+  },
+  "homepage.whatIs.rubyMore.description": {
+    "message": "T-Ruby는 Ruby에 추가적인 문법을 더해 강력하게 확장합니다. <strong>이는 정적 타입뿐 아니라 컴파일 타임을 의미합니다.</strong>",
+    "description": "Ruby and More description"
+  },
+  "homepage.whatIs.trust.description": {
+    "message": "T-Ruby 코드는 Ruby와 RBS로 변환되므로, <strong>Ruby, RBS가 동작하는 모든 생태계에서의 동작을 보장합니다.</strong>",
+    "description": "A Result You Can Trust description"
+  },
+  "homepage.whatIs.scale.description": {
+    "message": "T-Ruby를 통해 Ruby로 작성된 제품의 타입 안정성을 확보하세요. <strong>큰 규모에서도 안전한 상태를 유지할 수 있습니다.</strong>",
+    "description": "Safety at Scale description"
+  },
   "homepage.install.command": {
     "message": "gem install t-ruby",
     "description": "Install command"
@@ -264,7 +280,7 @@
     "description": "Feature description"
   },
   "homepage.codeShowcase.title": {
-    "message": "실제 동작 보기",
+    "message": "예시",
     "description": "Code showcase title"
   },
   "homepage.codeShowcase.subtitle": {
@@ -292,15 +308,15 @@
     "description": "Quick start title"
   },
   "homepage.quickStart.step1.title": {
-    "message": "T-Ruby 설치",
+    "message": "프로젝트 초기화",
     "description": "Step 1 title"
   },
   "homepage.quickStart.step2.title": {
-    "message": ".trb 파일 생성",
+    "message": "감시 모드 시작",
     "description": "Step 2 title"
   },
   "homepage.quickStart.step3.title": {
-    "message": "컴파일 및 실행",
+    "message": "타입이 있는 Ruby 작성",
     "description": "Step 3 title"
   },
   "homepage.quickStart.cta": {
@@ -323,6 +339,10 @@
     "message": "VS Code 확장",
     "description": "VS Code extension"
   },
+  "homepage.tooling.editors.jetbrains": {
+    "message": "JetBrains 플러그인",
+    "description": "JetBrains plugin"
+  },
   "homepage.tooling.editors.neovim": {
     "message": "Neovim 플러그인",
     "description": "Neovim plugin"
@@ -363,6 +383,66 @@
     "message": "모든 gem 작동",
     "description": "All gems work"
   },
+  "homepage.existingMethods.title": {
+    "message": "기존 방법들",
+    "description": "Existing methods section title"
+  },
+  "homepage.existingMethods.subtitle": {
+    "message": "기존 Ruby 타이핑 솔루션과 비교하고, T-Ruby가 어떻게 다른지 확인하세요.",
+    "description": "Existing methods section subtitle"
+  },
+  "homepage.existingMethods.howToUse": {
+    "message": "사용 방법",
+    "description": "How to use label"
+  },
+  "homepage.existingMethods.limitations": {
+    "message": "한계점",
+    "description": "Limitations label"
+  },
+  "homepage.existingMethods.vsTRuby": {
+    "message": "T-Ruby의 접근 방식",
+    "description": "T-Ruby approach label"
+  },
+  "homepage.contribute.title": {
+    "message": "함께 만들어가요",
+    "description": "Contribute section title"
+  },
+  "homepage.contribute.subtitle": {
+    "message": "T-Ruby는 오픈소스 프로젝트입니다. 여러분의 참여가 큰 힘이 됩니다.",
+    "description": "Contribute section subtitle"
+  },
+  "homepage.contribute.experimental": {
+    "message": "아직 실험 단계입니다. 핵심 컴파일러는 작동하지만, 개선할 부분이 많습니다.",
+    "description": "Experimental stage notice"
+  },
+  "homepage.contribute.feedback": {
+    "message": "피드백과 제안은 언제든 환영합니다!",
+    "description": "Feedback welcome notice"
+  },
+  "homepage.contribute.star.title": {
+    "message": "GitHub에서 Star 주기",
+    "description": "Star card title"
+  },
+  "homepage.contribute.star.description": {
+    "message": "응원을 보내주시고 더 많은 분들이 T-Ruby를 발견할 수 있도록 도와주세요",
+    "description": "Star card description"
+  },
+  "homepage.contribute.issue.title": {
+    "message": "이슈 제보하기",
+    "description": "Issue card title"
+  },
+  "homepage.contribute.issue.description": {
+    "message": "버그를 발견하셨거나 새로운 기능을 제안하고 싶으신가요? 알려주세요",
+    "description": "Issue card description"
+  },
+  "homepage.contribute.pr.title": {
+    "message": "코드 기여하기",
+    "description": "PR card title"
+  },
+  "homepage.contribute.pr.description": {
+    "message": "Pull Request를 제출하여 타입 안전한 Ruby의 미래를 함께 만들어가세요",
+    "description": "PR card description"
+  },
   "homepage.layout.title": {
     "message": "타입 안전한 Ruby",
     "description": "Layout title"

i18n/ko/docusaurus-plugin-content-docs/current/getting-started/installation.md

@@ -153,5 +153,5 @@ sudo dnf groupinstall "Development Tools"
 T-Ruby가 설치되었으니, 이제 코드를 작성해봅시다:
 
 - [빠른 시작](/docs/getting-started/quick-start) - 5분 만에 시작하기
-- [첫 번째 .trb 파일](/docs/getting-started/first-trb-file) - 상세한 안내
+- [.trb 파일 이해하기](/docs/getting-started/understanding-trb-files) - 상세한 안내
 - [에디터 설정](/docs/getting-started/editor-setup) - IDE 설정