Skip to content

Update from code changes: document static export URLs - #6875

Open
mintlify[bot] wants to merge 4 commits into
mainfrom
docs/static-export-html-links
Open

Update from code changes: document static export URLs#6875
mintlify[bot] wants to merge 4 commits into
mainfrom
docs/static-export-html-links

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Summary

Document the .html URLs emitted by static export bundles so they work on hosts without extensionless rewrites.

Changes

  • Explain root and page URL examples.
  • Describe CloudFront navigation and plain file hosting.
  • Note automatic configuration and extensionless canonical and sitemap URLs.
  • Document .html destinations for built-in internal navigation, including version and language switchers, search results, cards, assistant citations, and API playground links.

Context

This documents the static export URL changes in mintlify/mint#9840 and the follow-up imperative navigation fix in mintlify/mint#9842.


Note

Low Risk
Documentation-only changes to static export overview pages; no application or API code.

Overview
Documents how static export bundles expose pages as explicit .html URLs (e.g. /guides/getting-started.html, /index.html) so self-hosters know what to expect when uploading to S3 or plain static hosting without extensionless rewrites.

Adds a Page URLs in static bundles section (with anchor page-urls-in-static-bundles in localized pages) to the English, Spanish, French, and Chinese api/static-export/overview pages. The new copy explains that the Static Export API turns this on automatically, contrasts CloudFront (client nav/prefetch preserved) with file-only hosts (full-page .html links), and notes that canonical/sitemap and optional client nav URLs can stay extensionless—with a caveat that file-only hosts may need rewrites.

The Chinese overview also extends the frontmatter description with S3/CDN/static hosting context.

The localized overviews now also explain that built-in internal navigation uses .html destinations and preserves query strings.

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

Update history

  • 2026-08-05: Added coverage for the imperative navigation fixes in mintlify/mint#9842, including switchers, search, assistant, cards, and API playground links.

Note

Low Risk
Documentation-only updates to static export overview pages; no application or API code changes.

Overview
Adds a Page URLs in static bundles section to the English, Spanish, French, and Chinese api/static-export/overview pages, documenting behavior from recent static-export URL work in the main product.

The new copy explains that bundles expose explicit .html paths (e.g. /guides/getting-started.html, /index.html), that the Static Export API enables this without doc config changes, and how CloudFront (client nav/prefetch) differs from plain file hosts (full-page .html links). It also notes that built-in navigation—switchers, search, cards, assistant citations, API playground—targets .html URLs while preserving query strings, and that canonical/sitemap URLs can stay extensionless (with a file-host rewrite caveat).

Localized pages use anchor page-urls-in-static-bundles. The Chinese overview extends frontmatter description with S3/CDN/static hosting context.

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

@mintlify

mintlify Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Aug 5, 2026, 7:10 AM

@mintlify

mintlify Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
tomee 🟢 Ready View Preview Aug 5, 2026, 7:10 AM

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

@mintlify

mintlify Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor Author

Update from code changes updated this PR.

Updated wording, translation phrasing, heading consistency, and Chinese SEO metadata

Source PRs

  • mintlify/mint#9842 — fix(client): apply html-links extension to router.push nav targets

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