Skip to content

PRDCT-487: Tutorial & onboarding rework — descriptions + legacy-UI flags - #1012

Closed
Iamfle4ka wants to merge 2 commits into
mainfrom
PRDCT-359-tutorial-section
Closed

PRDCT-487: Tutorial & onboarding rework — descriptions + legacy-UI flags#1012
Iamfle4ka wants to merge 2 commits into
mainfrom
PRDCT-359-tutorial-section

Conversation

@Iamfle4ka

Copy link
Copy Markdown
Collaborator

Tutorial/onboarding section under the unified section-at-a-time method

Covers all 22 pages of /tutorial/ (getting-started parts 1–6, branches sub-tutorial, onboarding guides).

What changed

  • Every page now has description frontmatter (previously zero of 22) — feeds search, RAG, and meta tags.
  • tutorial/automate (Part 4): the walkthrough screenshots show the Legacy Flow Builder. Added a :::caution pointing readers to Conditional Flows, fixed the nav-label step to Conditional Flows (label verified live in-product), and flagged the walkthrough for re-recording on the conditional builder.
  • tutorial/ad-hoc (Part 5): the "Exploring Data" part still teaches the retired "New Sandbox" flow (the page's own caution admits it). Flagged for a rewrite on the current Workspaces UI with fresh screenshots.

Deliberately NOT done here

Verification

  • npm run build clean (258 pages).
  • node scripts/audit-phase2.mjs: MISSING IMAGES 0; broken internal links = 3 pre-existing on main (unrelated to this branch).

Draft — do not merge.

🤖 Generated with Claude Code

Nikita and others added 2 commits July 9, 2026 15:09
automate: the walkthrough screenshots show the Legacy Flow Builder —
added a caution pointing to Conditional Flows (nav label verified live)
and a TODO(human-review) to re-record on the conditional builder.
ad-hoc: flagged the 'Exploring Data' part for rewrite — it still shows
the retired 'New Sandbox' flow (page's own caution admits this).
Both pages also get description frontmatter.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
20 pages across load, manipulate, write, branches, and onboarding —
every tutorial page now has description frontmatter for search/RAG/meta.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@linear-code

linear-code Bot commented Jul 9, 2026

Copy link
Copy Markdown

PRDCT-359

PRDCT-487

@vercel

vercel Bot commented Jul 9, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
connection-docs Ready Ready Preview, Comment Jul 9, 2026 1:09pm

Request Review

@Iamfle4ka Iamfle4ka changed the title docs(tutorial): Tutorial & onboarding rework — descriptions + legacy-UI flags PRDCT-487: Tutorial & onboarding rework — descriptions + legacy-UI flags Jul 10, 2026
@Iamfle4ka

Copy link
Copy Markdown
Collaborator Author

Superseded by #1071, which rewrites the whole section as the Getting Started arc (this branch only added description: frontmatter and a legacy-UI flag — both carried over).

@Iamfle4ka Iamfle4ka closed this Aug 3, 2026
Iamfle4ka pushed a commit that referenced this pull request Aug 4, 2026
…d arc

Michal's 07-28 priority: Getting Started framed as the customer lifecycle,
written for readers (and agents) who know nothing and may land on a deep link.

Structure:
- /tutorial/ -> /getting-started/, redirect_from on every page
- steps renamed off "Part N": project (new), load, transform, write, automate,
  next-steps (new); optional deep-dives grouped under "Going Further"
- /tutorial/onboarding/ -> /overview/onboarding/ (SECTION-MAP U2: the subtree is
  explanation content, not tutorial steps), google-data-policy added to the nav
- description: frontmatter on all 22 pages (feeds search, RAG and the lede)
- 169 dead duplicate assets removed from src/content/docs — public/ is what
  serves absolute image paths; a single copy now lives under public/
- 431 path references repointed across 69 files; help.keboola.com self-links
  made relative

Supersedes #1012. Prose and screenshots follow.
Iamfle4ka pushed a commit that referenced this pull request Aug 4, 2026
…d arc

Michal's 07-28 priority: Getting Started framed as the customer lifecycle,
written for readers (and agents) who know nothing and may land on a deep link.

Structure:
- /tutorial/ -> /getting-started/, redirect_from on every page
- steps renamed off "Part N": project (new), load, transform, write, automate,
  next-steps (new); optional deep-dives grouped under "Going Further"
- /tutorial/onboarding/ -> /overview/onboarding/ (SECTION-MAP U2: the subtree is
  explanation content, not tutorial steps), google-data-policy added to the nav
- description: frontmatter on all 22 pages (feeds search, RAG and the lede)
- 169 dead duplicate assets removed from src/content/docs — public/ is what
  serves absolute image paths; a single copy now lives under public/
- 431 path references repointed across 69 files; help.keboola.com self-links
  made relative

Supersedes #1012. Prose and screenshots follow.
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