docs: propose interactive tutorial tab (accepted) - #4
Closed
MentorFilou wants to merge 5 commits into
Closed
Conversation
Proposal for a third top-level tab ('Learn'): a large editable IDE mock
(Markdown spec left, code right, terminal bottom) whose terminal executes
the real, release-pinned dist/flashtrace.mjs in a module Worker against
the editor buffers as in-memory tmp files. Guided chapters teach one
feature each, with 'Help me' / 'Do the next step for me' assists that
highlight and type inside the IDE, and completion tracked in an explicit
id-keyed localStorage map so newly inserted chapters are never
auto-checked.
Feasibility of the in-browser runner was verified with a proof of
concept against the v0.7.1 bundle; the shim approach and evidence are
documented in the proposal's appendix.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01L1msH7C8goUNt6fBB5VWQs
- entry point is a mini CTA button in the topbar action group; public label stays swappable by decoupling it from URL (/try/) and internal naming (tutorial) - progress entries carry detailed data: title, content-hash chapter identity (rev), language, and help/auto assist counters flagging assisted completions - chapter data model separates language-neutral content from per-language variants; v1 ships Markdown + JavaScript - editor buffers persist per chapter with a resume-or-start-fresh modal - chapter curriculum expanded to 11 candidates (Covers/orphans, capstone, keyword tables, anchored demands) pending v1 scope selection Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01L1msH7C8goUNt6fBB5VWQs
All 11 candidate chapters are confirmed for v1. The implementation plan is expanded into four executable milestone branches (runner, chapters + persistence, assists, polish) with per-file work items, the corrected build-time assertion (set equality over the bundle's node:* specifiers, since each built-in is imported multiple times), a shared report colorizer extraction, and per-milestone verification steps. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01L1msH7C8goUNt6fBB5VWQs
The four milestones become sequential commit stages on one feat/tutorial-tab branch, introducing the feature as one coherent PR (maintainer decision, recorded in the decision log). Every commit keeps the build green; the editor highlight overlay moves from non-goal to in-scope since stage 4 ships in the same PR. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01L1msH7C8goUNt6fBB5VWQs
All decisions are in (rev 3); implementation starts on feat/tutorial-tab. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Member
Author
|
This was just planning with Claude, no actual contribution in here. |
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
2 participants
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.
Adds the accepted proposal for the interactive tutorial tab ("Try it") at
/try/: a large editable IDE mock whose terminal executes the real, release-pinneddist/flashtrace.mjsin a module worker against in-memory buffers, with 11 guided chapters, assist buttons, and localStorage-persisted progress/buffers.All maintainer decisions are folded in and marked Decided (entry point, assist flagging, full 11-chapter v1 scope, JS-only code pane with language-ready data model, buffer persistence with resume modal, single-PR delivery). Feasibility of the in-browser runner is proven by the PoC in Appendix A.
Implementation follows separately on
feat/tutorial-tab.🤖 Generated with Claude Code