Skip to content

epic(tutorials): チュートリアルを上流のものに戻し、チュートリアルとデバッグは ? メニューに置く #1935

Closed
5 of 5 issues completed

Description

@smalruby3-editor-bot

目的

チュートリアルを、スモウルビー独自の修正を外して上流(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

  1. smalruby3-editor-bot commented on Nov 16, 2026

    @smalruby3-editor-bot
    Author

    調べた結果(案 1)

    基準は上流の tag v13.7.2、比べた相手は develop(0fa1a08009)。

    1. チュートリアルの中身(decks)

    src/lib/libraries/decks/ はほぼ全部が入れかわっている(1611 ファイル: 消した 1491・足した 114・変えた 6)。マーカーは 1 つも無い(ファイルごと入れかえているため)。

    • 上流のチュートリアル 30 本(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.jsx +330 / -8 42 組(コードを入れる・チュートリアルを始める・外のサイト・光る演出など)
    components/cards/cards.jsx +157 / -14 14 組
    components/cards/card.css +98 / -3 6 組(「コードを入れる」ボタンの色の取りいそぎの修正を含む)
    reducers/cards.js +31 / -5 5 組(pendingProjectTitle)。tutorialAllowedBlocks はマーカー無し
    lib/titled-hoc.jsx +33 / -8 6 組(チュートリアルを始めるときの作品名)
    components/library/library.jsx +43 / -15 5 組(チュートリアルのカテゴリの見出し)
    containers/tips-library.jsx +19 / -3 マーカー無し(1 行の説明だけ。選んだときに setup を入れる)
    components/debug-modal/sections/messages.js +14 / -14 マーカー無し(eslint-disable のコメントを消して空白だけの行が残っている。見た目は同じ)
    lib/query-parser-hoc.jsx +2 / -2 無し(lint の eslint-disable-line だけ)
    lib/tutorial-from-url.js 変更なし —

    3. 「?」メニュー

    もう develop でできている。 menu-bar.jsx の help menu マーカーの中に「チュートリアル」「デバッグ」があり、上流のメニューバーのボタンは「レッスン」ボタン(lessons button マーカー)に置きかわっている。テストは test/unit/components/menu-bar-help-menu.test.jsx。SP のドロワーにはチュートリアルが無い(SP 非対応)。
    → 案 3 で残っているのは「revert のあとも ? メニューのままにする」ことの確認と、「ほかに出す情報の入れ場所」を考えること。

    4. レッスンと共有しているもの

    共有しているもの 種類 revert で
    lib/deck-setup.js(applyDeckSetup) スモウルビー独自 残す。レッスンがチャレンジを始めるとき(lesson-mode.jsx)に使う。チュートリアル側(tips-library.jsx)は revert で使わなくなる
    blocks.jsx の tutorialAllowedBlocks マーカー付き レッスンは getLessonAllowedBlocks(state) || cards.tutorialAllowedBlocks で渡している。reducers/cards.js を戻すと、レッスンの分だけになる(動きは変わらない)
    lib/lesson-dynamic-categories.js・lib/lessons/block-defaults.js 独自 残す(レッスンのパレットの絞り込み)
    reducers/cards.js の closeCards・ACTIVATE_DECK 上流 そのまま使える(レッスンを始めるとカードを閉じ、チュートリアルを開くとレッスンを抜ける)
    reducers/tutorial-onboarding.js(markTutorialSeen) 独自 残す(レッスンの一覧を開くときにも使う)
    test/unit/lib/lesson-dynamic-categories-decks.test.js 独自 deck とチャレンジを 1 つのテストで確かめている。分けておかないと、deck を消したときにレッスンの確かめも一緒に消える
    cards/icon--close.svg などのアイコン 上流 甲子園のパネル・Ruby のプレビューが使う。上流のファイルなので残る

    レッスンのコンポーネント(lesson-hint・lessons-library など)は、チュートリアルのコンポーネントを import していない。「コードを入れる」の動きも、同じ考え方で別に書いてある。

    5. 人間に決めてほしいこと

    1. ?tutorial=chat1Basic1 などのリンク: 教科書・授業資料・開隆堂のページから使われているかもしれない。上流に戻すとこのチュートリアルが無くなるので、リンクは「チュートリアルの一覧が開く」か「何も開かない」になる。レッスンへつなぎかえるか、そのまま切るか。
    2. ブロックの本の試食(book-promo.jsx)と開隆堂のリンク: チュートリアルと一緒に消してよいか、別の場所(? メニューなど)に移すか。
    3. 上流のチュートリアルの画像: 戻すと 1491 ファイル(13 言語の画像・動画のサムネイル)がもどる。バンドルが大きくなる。

    分け方

    1. revert の下ごしらえ: レッスンの部品をチュートリアルから切り離す(見た目は変えない)← 最初にやる
    2. revert: decks・一覧・カードを上流の v13.7.2 に戻す(上の 1〜3 を決めてから)
    3. ? メニュー: revert のあとも ? メニューのままにする・ほかの情報の入れ場所
    4. docs とスクリーンショット
  2. added a commit that references this issue on Nov 17, 2026
  3. smalruby3-editor-bot commented on Nov 17, 2026

    @smalruby3-editor-bot
    Author

    sub-issue がすべて develop に入りました(PR #2028・#2156)。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions