docs: move Evals and Version history into a new Operations section - #806
jordanc-relevanceai wants to merge 1 commit into
Conversation
…s section Evals covers Agents and Workforces; version history covers Agents, Tools, and Workforces. Both lived under Agents. They now sit in an Operations section between Invent and Agents in the Build with Relevance AI tab. - Evaluate Performance keeps its dropdown - Version history is a single page, so it stays a single page - 6 redirects cover the moved URLs, plus 3 existing /evals shortcuts repointed - Inbound links updated repo-wide Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
🎯 Vibe checkReviewed: 40 files (6 with issues, 34 clean) Scores
Score key: 🟢 9–10, 🟡 6–8, 🔴 1–5. ✨ Overall vibe: The new guides section and the Evals documentation are both high quality — consistent structure, correct component choices, and clean prose throughout. One issue needs to ship clean: the plan-availability contradiction between the Evals introduction and the pricing page will actively mislead users deciding which plan to buy. 🔧 Issues (4)
🧩 Component suggestions (1)
|
| Item | Count |
|---|---|
| Files reviewed | 40 |
| Context pages read | 0 (cross-references were all within the changed file set) |
| Total lines processed | ~5,500 |
Files read: build/agents/create-an-agent.mdx (92 lines), build/invent/invent.mdx (360 lines), build/operations/evals/checks.mdx (123 lines), build/operations/evals/introduction.mdx (105 lines), build/operations/evals/monitor.mdx (55 lines), build/operations/evals/running-evaluations.mdx (110 lines), build/operations/evals/test-sets.mdx (132 lines), build/operations/version-history.mdx (89 lines), build/tools/create-a-tool.mdx (103 lines), build/workforces/create-a-workforce.mdx (46 lines), changelog.mdx (855 lines), get-started/pricing.mdx (271 lines), all 28 guide files (~96 lines each, ~2,688 lines total), docs.json (navigation scan, ~100 lines relevant)
NiamhRelevance
left a comment
There was a problem hiding this comment.
One small thing on the structure: is "Operations" a term we're using elsewhere? I haven't heard or seen it before, so just checking whether it's an agreed label before it lands here.
Also wondering whether evals and version history sit naturally together. Evals are more about testing and monitoring quality, and version history is about rolling back a change, so someone looking for either might not think to check Operations first.
What
Adds an Operations section to the Build with Relevance AI tab, sitting between Invent and Agents.
Evals and Version history both work across more than one builder object, but each was filed under Agents alone. They now live in one place.
Why these two:
evals/introductionsays it plainly: "It works on both Agents and Workforces."The Evals dropdown is preserved. Version history is one document, so it stays one document.
Moves
build/agents/evals/*(5 pages)build/operations/evals/*build/agents/build-your-agent/version-historybuild/operations/version-historyAlso in here
redirectsentries, one per moved URL/evals,/build/agents/evals, and/build/agents/build-your-agent/evalsshortcuts repointed at the new introductionmintlify broken-linkspasses. No page files deleted, no content rewritten.Scope
Agentsloses exactly two lines — theversion-historypage and theEvaluating Performancegroup.Tools,Workforce, andKnowledgeare byte-identical tomain.Two things for a follow-up, deliberately not fixed here
get-started/pricing.mdxlists Agent Evaluations as Enterprise-only, whileevals/introduction.mdxsays "Evals is available on every plan." One of them is wrong. Needs a product answer, not an edit.evals/test-sets.mdx—## How to Create a Test,## Managing Tests,## Example Tests. Pre-existing, and out of scope for a nav restructure.Supersedes #804, which used
Platformas the section name and also moved Tasks and Sharing.🤖 Generated with Claude Code