Skip to content

docs: route data owners through ingestion before use-case creation#31

Merged
saadqbal merged 1 commit into
developfrom
docs/fix-setup-guide-journey-30
May 11, 2026
Merged

docs: route data owners through ingestion before use-case creation#31
saadqbal merged 1 commit into
developfrom
docs/fix-setup-guide-journey-30

Conversation

@saadqbal
Copy link
Copy Markdown
Contributor

@saadqbal saadqbal commented May 11, 2026

Summary

  • Reworks the data-owner bullet in the setup-guide's "What's Next" section so it routes through ingestion first, then into use-case creation.
  • Replaces "select datasets" with "pick from prepared datasets" to match the homepage wording from docs: add "Bring your data" step to homepage journey #29.

Found by a broader audit of the docs site after #29 merged. Same inversion class — the data owner who finished the client install was sent straight to "create a use case" with no mention of ingesting data first.

-**Data owners:** [Create a use case](/create-use-case/prerequisites) — select datasets, define evaluation metrics, and invite contributors to submit models.
+**Data owners:** [Ingest your dataset](/create-use-case/prepare-dataset), then [create a use case](/create-use-case/prerequisites) — pick from prepared datasets, define evaluation metrics, and invite contributors to submit models.

Closes #30.

Audit status

Grep across origin/develop for select datasets|define datasets|active use case:

No further occurrences of the inversion pattern on develop. main still has the homepage hits because develop hasn't synced — separate operational concern.

Test plan

  • Visual review of the "What's Next" section in setup-guide.mdx
  • Both inline links (/create-use-case/prepare-dataset and /create-use-case/prerequisites) render correctly

🤖 Generated with Claude Code


Note

Low Risk
Low risk documentation-only change that updates navigation links and wording, with the main risk being broken/incorrect doc links or guidance.

Overview
Updates the Setup Guide "What's Next" guidance for data owners to direct them to dataset ingestion first (/create-use-case/prepare-dataset) and only then to use-case creation (/create-use-case/prerequisites).

Also refreshes the wording from "select datasets" to "pick from prepared datasets" to align terminology with the rest of the docs.

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

The setup-guide's "What's Next" sent data owners straight from "client
running" to "create a use case", with "select datasets" framed as a
sub-action of use-case creation. Same inversion pattern as the
homepage bug fixed in #29 — found during a broader audit.

Reword the data-owner bullet to route through ingestion first, then
into use-case creation, with "pick from prepared datasets" replacing
"select datasets" to match the homepage wording.

Closes #30

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 9 / 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.)

@saadqbal saadqbal merged commit b62cbb9 into develop May 11, 2026
5 checks passed
@divyasinghds divyasinghds deleted the docs/fix-setup-guide-journey-30 branch May 11, 2026 10:39
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.

4 participants