docs(invent): one Invent page, reached from a button on every tab - #817
Open
jordanc-relevanceai wants to merge 5 commits into
Open
jordanc-relevanceai wants to merge 5 commits into
jordanc-relevanceai wants to merge 5 commits into
Conversation
Each tab gets a nav button that points at its own Invent page, styled as one of the app's buttons rather than a nav link: a plain surface with a hairline brand ring, since Mintlify already uses a brand tint to mark the page you are on. Blobby sits fixed in the corner with his eyes tracking the cursor, mounted by invent-callout.js. The button is a tab-scoped global anchor rather than a page in the tab's groups, because Mintlify points a tab at its first page — listing the Invent page first made every tab link resolve to it. Each page still needs a home in its own tab's groups or the tab cannot be resolved while you read it and the anchor does not render; those group headings and rows are hidden in CSS instead, keyed on the shared /invent page naming. Enterprise has no button. New pages cover what Invent means in each tab: an introduction under Getting Started, integration reach and the Invent-versus-MCP distinction, the admin view of access, approvals and spend, and how to turn a role guide into a working Agent. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Each of the five Invent pages now opens with the Invent panel itself playing the task the page is about, in place of a static screenshot. Invent greets you, the prompt types itself into the composer, the panel goes to work, and the thing that now exists takes the stage. Then it loops. While a call has the floor the composer and its toolbar stand down and the thread takes the room: your message, one compact line per call made so far, and the window playing the current one. The panel's own height is fixed, so the page never jumps. Everything is measured off the product rather than approximated: InventorGreeting for the badge and its speech bubble, Inventor- SuggestedActions for the quick replies, InventorToolStepRow for the `Verb - target` lines, InventorMessageInput for the composer, and InventorToolScreen for the window. The window's wash is derived from each call's kind using the app's own rule, so a Create Tool cannot come out one colour on one page and another elsewhere. - new root invent-demo.js holds the five scripts and the schedule - .ivd- section in style.css holds the look; no dark-mode variant, because the product's panel is white - invent-callout.js gains a third placement so the greeting carries the real Blobby, cursor-tracking eyes and all - get-started and build give up their hero images (what-is-invent.png, invent-start-menu.png) to the demo; both files stay on disk, and invent-start-menu.png is still used further down the build page Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Scopes the Invent docs down to a single page. The four tab-specific pages leave the navigation and every tab's button now points at build/invent/invent, so there is one place to read about Invent instead of five near-duplicates. The retired .mdx files stay on disk and nothing in the docs linked to them. The animated panel demo is removed along with invent-demo.js and its styles; the page leads with a screenshot of the real panel again. The button itself: - renamed to "Use Invent", which reads the same from every tab. "Build with Invent" is the product's own Home page button, so reusing it for the docs nav gave one name to two things - gained a "New" badge. The Mintlify schema has no tag/badge property on an anchor, only on groups and versions, so it is a ::before — ::after is already Blobby's no-JS fallback, and flex order puts it after the label - gained a selected state on the Invent page, hooked to Mintlify's own aria-current rather than the page title so a rename cannot break it - Blobby moved inline beside the label, with the badge on the far edge The Invent group also moves to second in the Build tab. It was the last of 29 sidebar items, so Mintlify's scroll-into-view sent the sidebar to the bottom on every visit; it now sits near the top, and as a side effect the Build tab renders the button rather than a plain page row. The page itself: - opens with what Invent is and the fact it works across the whole project, then the panel screenshot - "What can Invent do?" becomes eleven icon accordions covering the real tool surface from builder-app's tool-names.ts, plus the alarm and MCP-server tools registered outside it - the after-launch paragraph moves to the "Manage performance" tab, which was opening straight onto accordions with no lead-in Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
Removing them from the navigation left four near-duplicate pages sitting on disk. There should be one Invent page, so they are deleted outright. Their URLs redirect to /build/invent/invent rather than 404ing, using the redirects list docs.json already keeps for retired pages. Nothing in the docs linked to any of them. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
…nges Clicking the Invent button was throwing the reader onto the Build tab. Mintlify resolves the active tab from the URL path, so a single page can only ever belong to one tab — listing it in every tab's groups, moving it to a site-level anchor, and moving it to the repo root were all tried and none of them hold the tab. So the page is mounted once per tab. The body lives in _snippets/invent.mdx and each tab's page is a thin include, so there is one thing to edit rather than six copies to keep in sync. - /get-started/invent, /build/invent, /integrations/invent, /admin/invent, /enterprise/invent, /guides/invent - each tab's button points at its own mount, and lights as selected only there; Enterprise gets the button for the first time - the path drops its doubled segment: /build/invent/invent -> /build/invent Two links inside the shared body pointed at /build/invent/invent#alerts. Left alone they would have sent a reader on any other tab over to the Build copy, which is the bug this commit exists to fix, so they are now bare anchors that stay on whichever mount is rendering. Inbound links in the changelog, the build introduction, and version history follow the flattened path. No redirects are added: the old paths only ever existed on this unmerged branch. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Consolidates the Invent docs to a single page, reached from an Use Invent button on every tab.
What changed
One body, mounted on every tab. The four tab-specific Invent pages had diverged into near-duplicates; they're gone. The content now lives once in
_snippets/invent.mdx, and each tab carries a thin page that includes it —/get-started/invent,/build/invent,/integrations/invent,/admin/invent,/enterprise/invent,/guides/invent. One thing to edit, six places it appears.This is deliberate rather than the single page it started as. Mintlify resolves the active tab from the URL path, so one page can only belong to one tab — clicking Invent from Guides was throwing the reader onto Build. Listing the page in every tab's
groups, moving it to a site-level anchor, and moving it to the repo root were all tried; none hold the tab. Mounting per tab is the only arrangement that does.The path also loses its doubled segment:
/build/invent/invent→/build/invent.The animated panel demo is gone, along with
invent-demo.jsand its styles. The page leads with a screenshot of the real panel again — refreshed to the current UI (images/invent-panel.png).The button:
tagon an anchor (only on groups and versions), so it's a::before—::afteris already Blobby's no-JS fallback, and flexorderputs it after the label.aria-currentrather than the page title, so a rename can't silently break it.Sidebar scroll fix. The Invent group moves to second in the Build tab. It was the last of 29 sidebar items, so Mintlify's scroll-into-view jumped the sidebar to the bottom on every visit to the page. Measured before and after:
scrollTop 704/704→0. As a side effect the Build tab now renders the button rather than a plain page row, which it wasn't doing before.The page:
What can Invent do?becomes eleven icon accordions — Agents, Tools, Workforces, Knowledge, Triggers, Evals and performance, Version control, Analytics and monitoring, Integrations and MCP, Working with you, Project setup. The capabilities are taken frombuilder-app/features/invent/v3/utils/tool-names.ts(the file that calls itself the canonical source of truth — 156 tools), plus the alarm and MCP-server tools registered outside it.Notes for review
build/tools/tool-steps.mdx.what-is-invent.pngis now unreferenced but left on disk (it's an asset, not a page).main; merges cleanly, no conflicts.Checks
.github/scripts/structure-check.jsclean on all touched.mdxdocs.jsonvalid; button, badge and selected state verified in a browser on all five tabs, light and dark🤖 Generated with Claude Code