- Drop the decision maker row from the participants table.
- Frame the success section as the value drivers customers commonly
measure Mintlify against, and add engineering time saved as a
fourth driver.
- Remove the Getting help section. Contacting your AE or SE is
already implied, and the opening note carries the support email.
- Refer to the AE and SE throughout instead of a generic Mintlify
representative, with the acronyms expanded on first use.
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
* Add hidden POC onboarding page
Adds poc-onboarding.mdx, a self-serve setup guide for enterprise
customers running a Mintlify proof of concept. Covers account and
repository setup, inviting the team, migrating sample content,
publishing a first change, branding, the AI assistant, SSO and
security, and a results review.
Written for non-technical readers, with each step naming who from
their team is needed and for how long.
The page is not listed in docs.json and carries noindex: true, so it
is reachable by direct URL only. This matches enterprise-contracting
and migration-services/go-live-checklist.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* Rework POC steps against the SE working session guides
Pulls the mechanics, prerequisites, and objection-handling from the
internal SE working sessions into the customer-facing steps.
Corrections:
- Authentication requires a custom domain or *.mintlify.app subdomain
and does not work on .mintlify.site or a custom basepath. The page
previously treated the custom domain as skippable during a POC and
auth as independent of it. Now flagged in step 1 and step 7.
- Separates dashboard SSO (who logs in) from site authentication (who
reads), with the real method taxonomy and the two-account test.
Additions:
- The repo/dashboard/live-site model up front.
- Step 4 rewritten with the actual editor flow, plus the point that
publishing writes a Git commit so CODEOWNERS and branch protection
still apply.
- Step 5 gets the docs.json theme keys, the light/dark check, and OG.
- Step 6 gets the three-way answer check (answered, correct, which
page cited), the description-quality lever, both MCP servers, the
contextual menu, and automations.
- Sample content chosen from top pages by traffic; two navigation
tests; Notion and Confluence sync as a third migration route.
- Success criteria reframed as one lever and one metric with a
recorded baseline.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* Tighten POC onboarding for house style
Editorial pass by Marco. Cuts roughly a third of the page: replaces
the conversational framing with a workflow table up front, converts
the intro card grids to prose and tables, and trims each step to the
action and its outcome.
All substance retained, including the authentication domain
requirement and the split between dashboard access and documentation
access.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* Apply review suggestions from @ethanpalm
Make the step names in the intro workflow table and the section
headings match exactly, and rename the participants table column to
Role.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
* docs(deploy): document instant rollbacks
Add deploy/rollbacks.mdx covering how to roll back to a previous build,
how to return to the latest build, generated files that stay frozen
during a rollback, and the current limitations. Link it from the
deployments page and note the new audit log actions.
Screenshots are placeholders pending review.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* 💅
* copy edit
* typo
* better grammar
---------
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
* docs: add help center article for private repo missing in second deployment onboarding
* docs: translate second-deployment private repo help article and tighten English title
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
* docs: add help center article for static file 404 troubleshooting
* docs: translate static-file-not-served help center article to es, fr, zh
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Four self-referential rules redirected /migration to /migration/index in
each language. The redirect matcher strips a trailing /index before
matching, so /migration/index matched the /migration rule and redirected
to itself, making the migration overview unreachable in all four
languages.
Remove those rules -- Mintlify serves migration/index.mdx at /migration
natively, the same as /assistant, /editor, and /automations -- and point
the /guides/migration redirects at /migration instead of /migration/index.
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
* Correct hidden, noindex, and llms.txt docs against implementation
- Add an llms.txt column to the hidden pages comparison table and split the
frontmatter vs. navigation-removal rows, which differ for the noindex tag
- Replace the "hidden: false is undefined behavior" claim with actual behavior
- llms.txt lists pages in navigation order, not repository order
- Descriptions come from the first paragraph, truncated at 300 characters; the
spec-info claim applies to llms-full.txt, not llms.txt
- Document the Optional section and the full Link header rel values
- Note the default language/version scope and that the 100k cap is llms.txt only
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* Correct what "Don't index project" does to search indexes
Enabling deployment-level noindex removes the site from Mintlify Index
(the universal search collection) via skipSite. It does not clear the
deployment's own Chroma collection, and no search, assistant, or MCP
query path checks deployment.noindex.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
mintlify/mint#10203 shipped the flag as `nocopy` (single name, no aliases).
Fixes the auto-generated docs from #7017 which used `noCopy` and described
aliases that don't exist. Also repairs the malformed fences in es/fr/zh.
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
* docs: add platform migration guides
* move migrations.mdx to migrations/index.mdx
* add doc360 and fern guides
* /goal loop
* copy edit index
* copy edit doc 360
* docusaurus copy edits
* fern copy edit
* gitbook copy edit
* copy edit go-live
* resolve TODOs
* manual copy edit
* readme copy edit
* Fix GitBook terminology, Document360 export steps, and revert banner examples
- migration/gitbook.mdx: GitBook renamed spaces to sections. Their current
docs use "section" exclusively across the Git Sync, content-structure,
content-configuration, and reusable-content pages. Update terminology
throughout, add a note about the older name, correct the Git Sync setup
steps to match the real flow (Set up next to Git Sync in the section
header, then pick a provider), and expand the direction warning with the
version-history rollback. Add a Vale.Terms toggle so .gitbook.yaml and
.gitbook/ paths do not trip the GitBook capitalization rule.
- migration/document360.mdx: fix "Document 360" typo and align the export
procedure with Document360's documented dialog order, including the
format selection, the Include media files checkbox, and downloading from
Recent files.
- Revert components/banner.mdx and its es/fr/zh copies. The /migration link
there is a placeholder inside an example, and translated content is
handled by the translation pipeline.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* Rename migration hub page to avoid duplicating its group name
The group is already called "Migrate to Mintlify", so the root page title
repeated it in the sidebar.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* Address migration guide nits: Fern paths, scraper page command, placeholders
- migration/fern.mdx: correct the source-content paths against Fern's
documented project structure. Pages live in fern/docs/pages/ and assets in
fern/docs/assets/. Add the previously missing fern/docs/snippets/,
fern/docs/changelog/, and fern/styles.css, note that only the fern and
changelog folder names are reserved, and map Fern snippets to Mintlify
snippets in the component table.
- migration/index.mdx: document the scraper's page command, which was only
documented in the deleted migration.mdx. Covered once here rather than
repeated in each scraper-supported platform guide. Also update the GitBook
card to say section instead of space.
- migration/readme.mdx: replace https://project.readme.io with
https://your-project.readme.io. The former is a real login-gated project.
- migration/docusaurus.mdx: remove trailing whitespace.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* remove go live checklist
* add launch your site snippet
* update index
* 💅
* 💅
---------
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
* docs: sync es/fr/zh translations for Aug 12-19 English updates
* docs: wrap translated personalization headings and trim overlong descriptions
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
mintlify-development[bot]