## 目的 チュートリアルを、スモウルビー独自の修正を外して上流(Scratch)のものをそのまま使う形に戻す。2026-11-15 に人間が決めた。 ## 方針(人間) - チュートリアルそのものは上流のものをそのまま使う。スモウルビー独自の修正は revert する(上流の追従のしやすさのため)。 - revert したあとも、**チュートリアルとデバッグは右上の ? メニューの中に入れておく**(メニューバーには出さない)。スモウルビーではメニューバーに置く必要がないため。? メニューには、ほかにも出したい情報がたくさんある。 - その前の取りいそぎの修正(「コードを入れる」ボタンの色など)は、この EPIC で revert してよい。 ## このあと(分け方の案) 1. 調べる: チュートリアルの decks・関係するコンポーネントのスモウルビー独自の変更の一覧(マーカーの有無も)。レッスン(チュートリアルを置きかえた独自の機能)と共有しているものを分ける。 2. revert: 上流の v13.7.2 の形に戻す(`.claude/rules/upstream-tracking.md` のベースライン)。 3. ? メニュー: チュートリアルとデバッグを ? メニューの中に置く(ほかに出す情報の入れ場所も考える)。 4. docs(`docs/design-system/tutorial-debug.md` など)とスクリーンショット。 関連: #1809(デザインシステム)、マーカーを付ける Issue
Activity
smalruby3-editor-bot commentedon Nov 16, 2026
調べた結果(案 1)
基準は上流の tag
v13.7.2、比べた相手は develop(0fa1a08009)。1. チュートリアルの中身(decks)
src/lib/libraries/decks/はほぼ全部が入れかわっている(1611 ファイル: 消した 1491・足した 114・変えた 6)。マーカーは 1 つも無い(ファイルごと入れかえているため)。urlId付き)と、言語ごとの画像・*-steps.js(am / ar / es / fr など 13 言語)は消してある。chat1Basic1〜chat3Mesh3の 9 本)、categories/の はじめよう・Ruby のきほん・ブロックの本の試食(book-promo.jsx)・DNCL(中身は空)。externalResources.kairyudo)がある。categories/*.locale.jsをlocales/en.js・ja.js・ja-Hira.jsが import している。tutorial-tags.js(マーカー無し): カテゴリCATEGORIESを足し、タグを ruby / mesh にした。2. チュートリアルの部品
containers/cards.jsxcomponents/cards/cards.jsxcomponents/cards/card.cssreducers/cards.jspendingProjectTitle)。tutorialAllowedBlocksはマーカー無しlib/titled-hoc.jsxcomponents/library/library.jsxcontainers/tips-library.jsxcomponents/debug-modal/sections/messages.jseslint-disableのコメントを消して空白だけの行が残っている。見た目は同じ)lib/query-parser-hoc.jsxeslint-disable-lineだけ)lib/tutorial-from-url.js3. 「?」メニュー
もう develop でできている。
menu-bar.jsxのhelp menuマーカーの中に「チュートリアル」「デバッグ」があり、上流のメニューバーのボタンは「レッスン」ボタン(lessons buttonマーカー)に置きかわっている。テストはtest/unit/components/menu-bar-help-menu.test.jsx。SP のドロワーにはチュートリアルが無い(SP 非対応)。→ 案 3 で残っているのは「revert のあとも ? メニューのままにする」ことの確認と、「ほかに出す情報の入れ場所」を考えること。
4. レッスンと共有しているもの
lib/deck-setup.js(applyDeckSetup)lesson-mode.jsx)に使う。チュートリアル側(tips-library.jsx)は revert で使わなくなるblocks.jsxのtutorialAllowedBlocksgetLessonAllowedBlocks(state) || cards.tutorialAllowedBlocksで渡している。reducers/cards.jsを戻すと、レッスンの分だけになる(動きは変わらない)lib/lesson-dynamic-categories.js・lib/lessons/block-defaults.jsreducers/cards.jsのcloseCards・ACTIVATE_DECKreducers/tutorial-onboarding.js(markTutorialSeen)test/unit/lib/lesson-dynamic-categories-decks.test.jscards/icon--close.svgなどのアイコンレッスンのコンポーネント(
lesson-hint・lessons-libraryなど)は、チュートリアルのコンポーネントを import していない。「コードを入れる」の動きも、同じ考え方で別に書いてある。5. 人間に決めてほしいこと
?tutorial=chat1Basic1などのリンク: 教科書・授業資料・開隆堂のページから使われているかもしれない。上流に戻すとこのチュートリアルが無くなるので、リンクは「チュートリアルの一覧が開く」か「何も開かない」になる。レッスンへつなぎかえるか、そのまま切るか。book-promo.jsx)と開隆堂のリンク: チュートリアルと一緒に消してよいか、別の場所(? メニューなど)に移すか。分け方
Merge pull request #2156 from smalruby/topic/tutorials-upstream
smalruby3-editor-bot commentedon Nov 17, 2026
sub-issue がすべて develop に入りました(PR #2028・#2156)。