Repository navigation
docs(tutorials): describe the upstream tutorials and retake the screenshots - #2069
Merged
smalruby3-editor-bot[bot] merged 204 commits intoNov 17, 2026
Merged
Conversation
…ade 2 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Define the hints of read-and-build challenges, the data the swimlane is drawn from, and keep the quiz position as the EPIC says until a human decides. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Put the quiz in the done balloon, allow 5 challenges and setup-loaded starts in lessons 4 and 5, count lesson 5 by one theme, keep the mesh connection, and let the lesson table scroll once there are 2 or more block courses. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
docs(lessons): 中 2「チャットをつくろう」の方針を design.md に書く
A challenge with `quiz: { question, choices, answer, explanation }` now shows
a 3-choice quiz inside the "You did it!" toast (also in "Lesson n complete!"
and "Assignment cleared!"). Choosing shows correct / wrong and the
explanation, and the student can choose again any number of times. The quiz
is not part of the completion check and nothing is recorded.
- courses.js: `quiz` default, `challengeQuiz(id, answer)`, `validateQuiz`
- lesson-completed-quiz.jsx: the quiz part (data-testid lesson-quiz-*)
- lessons.locale.js: quiz words in en / ja / ja-Hira
- docs/lessons: data format, testids, screenshots 0104-0106
Closes #1639
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…s a11y Address the round-1 review of PR #1812. - Q1: tapping the task bar full text no longer dismisses a toast with a quiz. The toast is hidden while the full text is open (lessonMode.completedHidden, hideCompleted / showCompleted) and shown again with the same answer when the panel closes. "Keep looking" stays an explicit dismissal. - FYI1: the quiz is a radiogroup of radios, the result starts with the chosen number so every pick is read, and the inner live region is gone. - FYI2: courses.test.js checks the ja-Hira quiz words have no kanji. - FYI3: picking a choice does not close the toast or go to the next one. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Draw a simple activity diagram (SVG) from the answer program of a challenge and show it in the full task text and on hint page 1 when the challenge sets activityDiagram: true. Mesh challenges with a partner definition get swimlanes. The model and layout are pure functions over the blocks that the Ruby to blocks converter makes from the answer code. Refs #1637 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
feat(lessons): 「できた!」の中に 3 択のふりかえりのクイズを出す
…utopilot-1637 # Conflicts: # docs/lessons/README.md # packages/scratch-gui/src/containers/lesson-mode.jsx # packages/scratch-gui/src/lib/lessons/courses.js
- read the practice partner in the #1638 shape (label/onBroadcast, set, broadcast) and write the shape in design.md - keep the diagram at a readable scale; the full text shows a line pointing to the hint when it does not fit, the hint scrolls - test the hook cache, repeat until, nesting and empty answers - no end symbol after forever; add a title and a text alternative Refs #1637 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…rowser A challenge can define a data-only partner (name, buttons, automatic replies). The panel next to the stage acts as the partner on the mesh without the server: values go to the mesh extension's remoteData, messages start the receive hats. It does nothing while the real mesh is connected and removes what it put in. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The merge of the quiz branch kept the old expectation of defineChallenge without the two new defaults, so courses.test.js failed in CI. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Describe the data-only partner shape, the in-browser loopback, the panel place at 1300x600 (top right of the code area, the stage column does not move) and that the mesh group survives a challenge change. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
feat(lessons): 答えのプログラムからアクティビティ図を描き、課題の全文とヒントの 1 ページ目に出す
…utopilot-1638 # Conflicts: # packages/scratch-gui/.prettierignore # packages/scratch-gui/src/lib/lessons/courses.js
- remember the node id of each own seeded value and remove it from that node - keep one pending reply per message name (cap 100), like fireEvent merges - remove practice values at the step after connecting starts - move focus to the open button / first partner button when the panel toggles - drop the unused hasPracticePartner and document that sentBy cannot tell mesh messages apart Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
feat(lessons): add the mesh practice partner that loops back in the browser
A challenge with mode: 'readDiagram' is given only by the explanation and the activity diagram. The diagram is always shown, the task bar shows a "read and build" tag, and the hint has only 3 pages: the diagram and the explanation (auto-opened), a try page, and an answer page that draws the whole answer in the balloon without replacing the student's program. There is no last-resort page. Judging is the same as other challenges. The hint balloon is now placed and sized below the lesson task bar, so tall balloons next to the stage no longer hide their header under it. Closes #1640 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Q1: the answer page draws code, or the first spriteCodes entry when there is no code, and names whose program it is when there is more than one script (e.g. "Program of Cat"). - Q2: courses.test.js checks every readDiagram challenge has an answer program; applyChallengeMode warns in development and never throws. - FYI1: test the inline max-height of the hint below the task bar. - FYI2: center the hint with no target in the area below the task bar. Refs #1640 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
feat(lessons): 説明とアクティビティ図だけで指示する「読んで作る」チャレンジ
…nswer Add setup.sprites (replace the cat of the new project with library sprites such as Shimaraby and Shimacat), setup.code / spriteCodes / stageCode (put the answer of the previous step into the project when the challenge starts) and allow a list of names in the goal trigger.message so either role of a pair passes. Closes #1936 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- mark the project unchanged after the start set it up (no "replace the project?" when choosing another challenge) - show Shimaraby / Shimacat in the words of the locale in the diagram headings - skip a sprite or a program that fails and go on; stop when another challenge or project takes over - convert in the Ruby version of the setup; take an added sprite by the diff; share the choice of the code sprite with "insert the program" - check that every setup sprite is in the sprite library Refs #1936 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…e practice partner Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… from variables
- the practice partner panel shows one line: the last message the student
project sent (with the shared value of the same name) or the last shared
variable and its value (D3)
- a partner value may be { fromVariable } to use the value of a variable of
the student project, or empty without it; the diagram draws it as
"(name の値)" (D4)
Closes #1937
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
feat(lessons): start challenges with library sprites and a previous answer
Keep the panel width; fix the line area at two lines (overflow is cut, the full text is in the title) so the panel height never moves. Shorten the prefix to "届いた:" / "とどいた:" / "Received:". Refs #1937 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- reattach the loopback per challenge so a challenge with the same partner starts over (M1) - show only the variables the partner uses, tell at most once per frame, and read aloud only when a message reached the partner (Q1) - read the partner lane of the diagram with normalizePartner, the same as the practice panel, including per-locale names (Q2, Q3) - match the variable of a message by exact name first (FYI2); say "up to two lines" in the comments (FYI1) Refs #1937 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… panel Add an optional `watch` (names of student variables, per locale too) to the partner definition. They join partnerNames, so the panel shows them even when the partner itself does not use them (3-3: the own mood). Partners without `watch` work as before. Refs #1937 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Course and lesson headings become buttons (aria-expanded / aria-controls, Enter and Space). When the library opens, only the course in progress and its current and next unfinished lessons are open; done and later lessons fold into one line with a dot per challenge. Searching and the class assignment library open everything. The rule is the pure initialFoldState in lib/lessons/library-fold.js. Refs #2148 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Refs #2148 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Refs #2148 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ints change 0-5 starts with turn 15 degrees and go to mouse-pointer, so hint 1 changes the number and hint 2 the ▼ of blocks already in the code area; the goal checks both. 0-6 starts with Shimaraby (2 costumes) and only asks to choose the 2nd costume. Hint balloons no longer cover the costume/sound list or the scripts in the code area. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…eat/lessons-l0-content-2146
feat(lessons): make the guide button match the hint button
…eat/lessons-l0-content-2146 # Conflicts: # packages/scratch-gui/src/lib/lessons/courses.js
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ests Lesson 2 and 3 start folded, so open them before measuring the card bands, and pick only the lesson sections (the headings now have testids too). Refs #2148 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
feat(hosting): 本番の CloudFront のアクセスログを非公開バケットに残す
feat(hosting): DNS と配信内容を照合するスクリプト
# Conflicts: # docs/infra/smalruby-web-hosting.md
feat(lessons): give lesson 0 a two-costume sprite in 0-6 and clearer blocks in 0-5
# Conflicts: # docs/infra/smalruby-web-hosting.md # infra/smalruby-web-hosting/test/web-hosting.test.ts
feat(lessons): fold the lessons library to the lessons in progress
feat(hosting): prod に smalruby.app の Route 53 ゾーンを作り、お名前.com のレコードを写す
Re-render the map with the guide button in the task bar, and call the button ガイド in the teacher script. Hints now open in every challenge. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…d the minimize button Retake the task bar and hint screenshots of lesson 0 and lesson 1 that still showed the old part names button or the close button of the hint. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
docs(lessons): finish the first step with the guide button (0.1.2 and screenshots)
feat(lessons): first step — lesson 0 and help for stuck students
Keep the first-step lesson (#2136) and point it at lib/lessons/apply-setup.js (applySetup / normalizeRubyVersion) instead of the moved lib/deck-setup.js. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ot-2024 Keep the first-step lesson and the standard assignments from develop next to the reverted tutorials: the activity diagram locale import, the sprite-library marker row, and both the assignments and the tutorial images in the precache exclusions. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ot-2026 In the mesh rule, list only the scripts that are still in tools/playwright-verify (the tutorial mesh check goes with the tutorials, and develop removed the two sensor notice checks). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
smalruby3-editor-bot
Bot
merged commit Nov 17, 2026
e245929
into
topic/tutorials-upstream
41 checks passed
This branch was previously deployed
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.
概要
チュートリアルを上流に戻したこと(#2065)と「?」メニュー(#2067)を、docs とスクリーンショットに反映する(EPIC #1935 の 4 つめ)。
変えたこと
docs
docs/tutorial/README.md: 中身と部品は上流の v13.7.2 のまま、学ぶ入口はレッスン、と書きなおした。バッジは 🔧 のまま(改良点を「入口を ? メニューへ・古いリンクの GA 計測・画像を開いたときだけ読む」に)。「GA の計測」「画像の読み込み」を足した。docs/tutorial/improvement-plan.md・progress.mdを消した(消したスモウルビーのチュートリアルの計画と進み具合)。docs/tutorial/book-kirakira-ruby-source.mdは残し、冒頭に「いまは使っていない。レッスンで紹介しなおすときの材料」と書いた(人間の答え t2: レッスンで紹介する予定)。docs/design-system/tutorial-debug.md: 「スモウルビーの追加」から decks・カードの行を消し、実測を上流の値に(カード 468px・手順の絵 450×200 まで・点の色rgba(255, 255, 255, 0.25)。どれも一致)。見本の説明を直した。docs/design-system/menu-bar.md・screenshots/README.md、docs/lessons/README.md(「いまのチュートリアルの入口」など、チュートリアルと共有していた説明)、docs/welcome/README.md(「?」メニューの項目)、docs/ruby-editor/README.md(消したテストへの参照)。スクリーンショット(1366×1024 / 1280×800、headless Chromium・
build:dev。Google・生徒のデータは写っていない)docs/menu-bar/screenshots/0102-help-menu-1280x800.pngdocs/welcome/screenshots/0201-about-menu-desktop.pngdocs/tutorial/screenshots/0201-tips-library-1280x800.png・0101-tutorials-modal.pngdocs/design-system/screenshots/0902-tutorial-card.png・0509-pager-tutorial.png道具とルール
verify-ruby-basics-*・generate-ruby-basics-*・verify-tutorial-mesh-categories.mjs)を消した。.claude/rules/scratch-gui/tutorial.md(スモウルビーのチュートリアルを作るためのルール)を消し、e2e-test.md・mesh.mdから消したスクリプトの行を外した。確かめたこと
npm run lint:secrets、docs の中の消したファイルへのリンクが残っていないこと(grep)Closes #2026
🤖 Generated with Claude Code