Skip to content

Datasets: a page that follows the journey, with row shapes, errors and limits - #37

Closed
freyam wants to merge 5 commits into
mainfrom
docs/data-workshop-journey
Closed

freyam wants to merge 5 commits into
mainfrom
docs/data-workshop-journey

Conversation

@freyam

@freyam freyam commented Sep 17, 2026 •

Copy link
Copy Markdown
Contributor

What

Rewrites the Datasets page for users. It now follows what they do, in order: Create → First scan → Review → Use, and leaves out how the system works inside.

On the page:

  • What each purpose gives you, including Train + eval
  • What the agent does on its first scan, and what it never does for you
  • A valid training row and a valid evaluation row, one small example each
  • The common refusals and the fix for each
  • Four limits a user can hit
  • Three CLI commands, with links to the CLI, MCP and API pages for the rest

Also:

  • models/training.mdx: overlapping train and eval traces refuse the job; the old text said the rows were excluded
  • platform/cli.mdx: documents overmind dataset upload --wait and --cell 1.2
  • Inbound links updated to the new headings

Why

Pairs with overmind-core/overmind#103 (issue overmind-core/overmind#91). The old page was long, written from the system's point of view, and had no row examples and no list of errors.

Verification

Every message and limit on the page was checked against the code on the platform branch. No docs build was run locally.

… errors and their fixes, limits, and the CLI and MCP paths
@mintlify

mintlify Bot commented Sep 17, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
overmind-core 🟢 Ready View Preview Sep 17, 2026, 10:55 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

pritamsoni-hsr pushed a commit that referenced this pull request Oct 1, 2026
… a full proofread (#54)

* Document account MCP access and optional plugin

* Document Windows installs of the overmind CLI

Virtual environment, PATH, execution policy and the long-path limit for the tracing extra.

* Document server-side span pricing and drop the litellm long-path note

* Put CLI install steps for macOS, Linux and Windows in one tabbed section

* Draw one underline on content tabs and keep the focus ring inside the tab

* Keep code-block buttons from covering the code

Hide Mintlify's fade overlay, give the button group its own chip, and keep the header rule off it.

* Clip code before its floating buttons instead of under them

Reserve a gutter for the buttons in the code viewport; drop the chip and restore the header rule's exclusion.

* Drop the span pricing note from the observability page

* Document local Codex setup and training input format

* Document self-hosting and Claude Code onboarding as they run

Startup needs only OpenRouter; Claude Code MCP is local scope; verify by trace_id.

* Make OpenRouter the one required key

* List required and optional self-host keys

* Remove statements that are no longer true

* Match the sync path in the scan diagram

* Fold #37 into Datasets: row shapes, refusals and limits

* Fold #40 into the introduction and quickstart

* Document ingest pricing, the repository snapshot and re-scan after delete

* Make the merged MCP and training text read the same way

* List every MCP tool argument the server accepts

---------

Co-authored-by: Tyler-Edwards <Tyler@overmindlab.ai>
freyam added a commit that referenced this pull request Oct 2, 2026
* Document account MCP access and optional plugin

* Document Windows installs of the overmind CLI

Virtual environment, PATH, execution policy and the long-path limit for the tracing extra.

* Document server-side span pricing and drop the litellm long-path note

* Put CLI install steps for macOS, Linux and Windows in one tabbed section

* Draw one underline on content tabs and keep the focus ring inside the tab

* Keep code-block buttons from covering the code

Hide Mintlify's fade overlay, give the button group its own chip, and keep the header rule off it.

* Clip code before its floating buttons instead of under them

Reserve a gutter for the buttons in the code viewport; drop the chip and restore the header rule's exclusion.

* Drop the span pricing note from the observability page

* Document local Codex setup and training input format

* Document self-hosting and Claude Code onboarding as they run

Startup needs only OpenRouter; Claude Code MCP is local scope; verify by trace_id.

* Make OpenRouter the one required key

* List required and optional self-host keys

* Remove statements that are no longer true

* Match the sync path in the scan diagram

* Fold #37 into Datasets: row shapes, refusals and limits

* Fold #40 into the introduction and quickstart

* Document ingest pricing, the repository snapshot and re-scan after delete

* Make the merged MCP and training text read the same way

* List every MCP tool argument the server accepts

* Scale diagrams to fit the column at every width

* Stack table rows on phones, each cell captioned with its column

* Drop the cards' second inner padding

* Put the mobile navbar on one row

* Keep the copy-page control on the title row

* Fit Ask Assistant in the title row and match the navbar icon colour

* Make the page-menu buttons equal squares on phones

---------

Co-authored-by: Tyler-Edwards <Tyler@overmindlab.ai>

This branch was successfully deployed

1 active deployment
staging — b3e3cce2 Deployed Sep 17, 2026 by mintlify[bot]
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