feat(tutorial): split mesh tutorials into 3 step categories (Phase 1)#683
Merged
Conversation
Mesh チュートリアル 9 deck を「メッセージを送ってみよう」「ふたりで会話しよう」
「みんなで会話しよう」の 3 カテゴリ × 3 lv 構成に再分類し、ステップ軸と Lv 軸の
2 軸構造を tipsLibrary 上で分かりやすく表示できるようにする。
- tutorial-tags.js: CATEGORIES.chatApp を削除、meshStep1/2/3 を追加
- library.jsx: local messages mapping を新カテゴリ 3 つに更新
- decks/index.jsx: 9 deck の category 参照を新キーに変更 (deck ID は維持)
- locales/{en,ja,ja-Hira}.js: gui.library.meshStep1/2/3 の翻訳を追加、
廃止した gui.library.chatApp を削除
docs/tutorial/improvement-plan.md でチュートリアル全体の拡充計画
(Phase 1〜4: Mesh / Ruby / Block / DNCL) を文書化し、Phase 3 では書籍
プロモーション戦略 (Lv0/Lv2/Lv3 番号付けで Lv1 を「書籍を読んで理解する段階」
として空ける)、横断的な setup プロパティによるタブ・モード・拡張機能の
自動セットアップ機構などを設計判断として記録した。
docs/tutorial/progress.md は進捗トラッカー (全 Phase 完了時に削除予定)。
tools/playwright-verify/verify-tutorial-mesh-categories.mjs で
tipsLibrary に 3 カテゴリが想定通り表示されることを自動確認できる。
Refs: #678, #682
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
🚀 Preview deployed: https://smalruby.jp/smalruby3-editor/feature/tutorial-mesh-recategorize/ |
PR レビューでカテゴリの連続性が伝わらない指摘を受け、ストーリー型単独名から
共通プレフィックス「通信入門」+ 番号付きシリーズ名に変更。3 カテゴリが同じ
シリーズの段階的なステップであることを名前から一目で識別できるようにする。
カテゴリ表記:
- meshStep1: 通信入門 ① メッセージを送ってみよう
- meshStep2: 通信入門 ② ふたりで会話しよう
- meshStep3: 通信入門 ③ みんなで会話しよう (メッシュ)
合わせて Step 3 の Lv1 deck 名を「メッシュ拡張機能でつながろう」から
「メッシュでつながろう」に短縮し、Lv2 / Lv3 の表記と揃える。
- library.jsx, locales/{en,ja,ja-Hira}.js: 新カテゴリラベル / Lv1 deck 名
- tutorial-tags.js, decks/index.jsx: コメント表記の整合
- docs/tutorial/improvement-plan.md, progress.md: 命名理由を追記
- verify-tutorial-mesh-categories.mjs: 期待値を新表記に更新
Refs: #678, #682, #683
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
github-actions Bot
pushed a commit
that referenced
this pull request
May 11, 2026
…ial-mesh-recategorize feat(tutorial): split mesh tutorials into 3 step categories (Phase 1)
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
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.
Summary
Phase 1 of the tutorial expansion roadmap (#682): split the single
CATEGORIES.chatApp(which housed 9 decks = 3 steps × Lv1〜3) into 3 story-themed categories × 3 lv so the tipsLibrary surfaces the step axis and the lv axis as distinct dimensions.meshStep1("メッセージを送ってみよう"),meshStep2("ふたりで会話しよう"),meshStep3("みんなで会話しよう")category:references and translations are updatedAlso lands the tutorial expansion roadmap (
docs/tutorial/improvement-plan.md) covering Phase 1〜4 (Mesh / Ruby / Block / DNCL) and a working progress tracker (docs/tutorial/progress.md) for the multi-phase effort.Changes
packages/scratch-gui/src/lib/libraries/tutorial-tags.jsCATEGORIES.chatApp, addmeshStep1/2/3packages/scratch-gui/src/components/library/library.jsxmessagesmapping: removechatApplabel, add 3 new mesh-step labelspackages/scratch-gui/src/lib/libraries/decks/index.jsxcategory:for 9 chat decks (chat-1-basic-{1,2,3} → meshStep1, chat-2-sprites-{1,2,3} → meshStep2, chat-3-mesh-{1,2,3} → meshStep3)packages/scratch-gui/src/locales/{en,ja,ja-Hira}.jsgui.library.meshStep1/2/3translations, removegui.library.chatAppdocs/tutorial/improvement-plan.mdsetupfoundation,puts-centric Ruby strategy, book promotion strategy with Lv0/Lv2/Lv3 numberingdocs/tutorial/progress.mdtools/playwright-verify/verify-tutorial-mesh-categories.mjsVerification
Screenshot:
tools/playwright-verify/tmp/tutorial-mesh-categories.png(gitignored).Test plan
Closes
Related
puts-centric, withsetupfoundation) → feat(tutorial): Phase 2 - Ruby チュートリアル拡充 (TryRuby ベース、puts 中心) + setup 基盤 #679🤖 Generated with Claude Code