Skip to content

docs(website): restore the /tutorial walkthrough#1544

Draft
samchon wants to merge 1 commit into
masterfrom
restore/tutorial
Draft

docs(website): restore the /tutorial walkthrough#1544
samchon wants to merge 1 commit into
masterfrom
restore/tutorial

Conversation

@samchon

@samchon samchon commented Jul 18, 2026

Copy link
Copy Markdown
Owner

Intent

The ten-step walkthrough promoted to /tutorial in #1543 shipped before it was finished, so master withdrew it in e32e3c6. This pull request holds the restoration while the walkthrough is completed.

This is not ready to merge. The tutorial content is still incomplete — that is why it was withdrawn. The branch exists so the removal is reversible in one place, with the full surface already wired back up, rather than needing to be reconstructed from scratch later.

Scope

A pure revert of e32e3c6. The resulting tree is byte-identical to e6e1d96 — verified with git diff --stat e6e1d964 HEAD, which is empty.

Restored:

Surface Restored
website/src/content/tutorial/** 10 pages + _meta.ts
website/public/docs/tutorial/** 10 redirect stubs for the old nested URLs
website/build/tutorial-redirects.py stub generator
src/content/_meta.ts navbar 🚀 Tutorial page entry
src/content/docs/_meta.ts sidebar href entry
HomeHeroMovie.tsx hero CTA back to /tutorial
next-sitemap.config.js /tutorial priority branch
page.jsx tutorial arm of the isDocsPage marker
11 guide .mdx 24 inbound links + the 8 Callout imports they need
.agents/skills/documentation/SKILL.md tutorial-location prose

Deferred

Finishing the tutorial content itself. Every page under src/content/tutorial/** is restored as it was written, not as it needs to be.

Verification

Ran locally:

  • git diff --stat e6e1d964 HEAD — empty, so the restored tree matches the pre-removal state exactly.
  • A content-tree check confirming every _meta.ts key resolves to a real page and every internal MDX link resolves to a real route.

Not run locally: the full next build. It requires pnpm run package:tgz to produce editor.tgz and migrate.tgz first, and that step would not complete in the authoring environment — pnpm pack aborted with 0xC0000142 (STATUS_DLL_INIT_FAILED) on one attempt and hung on the Go-native packages on another. The website workflow runs the identical build on this pull request, so CI is the real gate here.

Unrelated pre-existing issues noticed

Neither is touched by this branch:

  • pnpm format fails repository-wide on packages/sdk/assets/bundle/e2e/index.ts (SyntaxError: Unexpected token at 10:13), a file untouched since 6487692. It also reformats ~258 files, meaning the tree has drifted from the current prettier.
  • /downloads/editor.zip is linked twice from docs/swagger/editor.mdx; the path is gitignored and generated at build time by website/build/editor.js.

🤖 Generated with Claude Code

Reverts e32e3c6, which withdrew the ten-step walkthrough from the
published site because it shipped unfinished.

This restores the tree exactly as it stood at e6e1d96: the ten pages
under src/content/tutorial/**, the public/docs/tutorial redirect stubs,
build/tutorial-redirects.py, the navbar and sidebar entries, the sitemap
priority branch, the isDocsPage marker arm, the 24 inbound links across
the guide pages, and the home hero CTA.

The tutorial content is still incomplete. This pull request exists to
hold the restoration while the walkthrough is finished; it is not ready
to merge as-is.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant