Skip to content

Fix API reference content/code-rail collision#327

Open
bcrowther1 wants to merge 2 commits into
mainfrom
feat/ia-restructure
Open

Fix API reference content/code-rail collision#327
bcrowther1 wants to merge 2 commits into
mainfrom
feat/ia-restructure

Conversation

@bcrowther1

Copy link
Copy Markdown
Contributor

Summary

  • On API reference endpoint pages, the main content column could overlap the sticky request/response code rail at certain viewport widths (~1650–1765px and when zoomed out).
  • Root cause: the global #content-area rule uses viewport-based centering (50vw), which above 1650px pushes the 820px column rightward into the rail's flex track.
  • Fix: keep the same 820px column, but on /api-reference/endpoint/ pages center it within its own flex track instead of the viewport, so it can never cross into the rail. Scoped by path (covers all locales); plain API pages (Introduction/Rate Limits/Error Codes) and all normal docs pages are unaffected.

Test plan

  • Load an endpoint page (e.g. /api-reference/endpoint/image/generate, /api-reference/endpoint/chat/completions).
  • Resize/zoom across ~1440px → 1920px; confirm the prose never overlaps the code rail (verified gaps: 1700px→60px, 1765px→92px, 1920px→170px).
  • Confirm normal doc pages keep the existing viewport-centered column.
  • Spot-check a localized endpoint page (e.g. /es/api-reference/endpoint/image/generate).

Made with Cursor

bcrowther1 and others added 2 commits July 10, 2026 11:09
Our global 820px content-centering rule ignored the sticky request/response
code rail on OpenAPI endpoint pages, so the prose slid under it on narrower
viewports. Scope the centering off for /api-reference/endpoint/ pages (all
locales) and let Mintlify's native two-column layout reserve the rail.

Co-authored-by: Cursor <cursoragent@cursor.com>
The prior fix widened the prose to full width on large screens. Instead keep
the same 820px column and, on /api-reference/endpoint/ pages, center it within
its own flex track (not the viewport) so it never crosses into the sticky code
rail. Verified no overlap from 1440px through 1920px, including the ~1650-1765px
band where the collision occurred.

Co-authored-by: Cursor <cursoragent@cursor.com>
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