Skip to content

docs: add "Bring your data" step to homepage journey#29

Merged
saadqbal merged 2 commits intodevelopfrom
docs/fix-homepage-journey-order-28
May 8, 2026
Merged

docs: add "Bring your data" step to homepage journey#29
saadqbal merged 2 commits intodevelopfrom
docs/fix-homepage-journey-order-28

Conversation

@saadqbal
Copy link
Copy Markdown
Contributor

@saadqbal saadqbal commented May 8, 2026

Summary

  • Adds an explicit "Bring your data" step to the homepage's "How It Works" between workspace creation and use-case definition.
  • Rewords Step 2 from "Select datasets, set evaluation metrics" to "Pick from your prepared datasets, set evaluation metrics" so it doesn't read as a UI action performed during use-case creation.
  • Same rewording on the matching "Next Steps" card.

The homepage previously inverted the actual journey: it jumped from "Create your AI workspace" straight to "Define a use case", with datasets selected as a sub-action of that step. That contradicted /create-use-case (which correctly lists ingestion as the first workflow step) and sent newcomers into the platform looking for a dataset selector with no datasets to select.

Cross-references the same bug class in tracebloc/data-ingestors#66 (Readme prereq listed "active use case" as required before ingest).

Closes #28

Diff

   <Step title="Create your AI workspace">…</Step>
+  <Step title="Bring your data">
+    Validate and stage your datasets on your cluster. Metadata syncs to the web app — raw data stays put.
+  </Step>
   <Step title="Define a use case">
-    Select datasets, set evaluation metrics. Use a template or build your own.
+    Pick from your prepared datasets, set evaluation metrics. Use a template or build your own.
   </Step>

Test plan

  • Mintlify preview renders the 6-step <Steps> block correctly (was 5).
  • "Next Steps" card wording matches the rest of the homepage tone.
  • Homepage journey now matches /create-use-case ordering.

🤖 Generated with Claude Code


Note

Low Risk
Low risk documentation-only update that reorders and rewords homepage guidance; the main risk is minor messaging/UX confusion if the new step copy is inaccurate.

Overview
Updates the overview/tracebloc.mdx homepage journey to explicitly include a “Bring your data” step between workspace setup and use-case definition, clarifying that datasets are validated/staged on the user’s cluster and only metadata syncs.

Rewords related copy in the hero and “Next Steps” cards and the “Define a use case” step to emphasize picking from prepared datasets rather than selecting datasets during use-case creation.

Reviewed by Cursor Bugbot for commit a5bd224. Bugbot is set up for automated code reviews on this repo. Configure here.

The homepage's "How It Works" jumped from "Create your AI workspace"
straight to "Define a use case", with "Select datasets" framed as a
sub-action of use-case definition. That inverted the actual journey
(ingest first, then define a use case from your prepared datasets)
and contradicted /create-use-case, which gets it right.

Adds an explicit "Bring your data" step between workspace creation
and use-case definition, and rewords Step 2 + the Next Steps card so
"Select datasets" no longer reads as a UI action performed during
use-case creation.

Closes #28

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@LukasWodka
Copy link
Copy Markdown
Contributor

👋 Heads-up — Code review queue is at 14 / 8

Above the WIP limit. The team convention is to review existing PRs before opening new work.

Open PRs currently in Code review (oldest first):

Pull from review before opening new work. (This is a nudge from the kanban WIP check, not a block.)

The hero CardGroup at the top of the homepage said "Define datasets,
set metrics, invite contributors" — same inversion as the "How It
Works" steps and the "Next Steps" card, framing datasets as something
configured during use-case creation. The previous commit fixed the
two visible spots but missed this one.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@saadqbal saadqbal merged commit 6f5dae6 into develop May 8, 2026
4 checks passed
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.

3 participants