Skip to content

Docs: refine docs layout to widen content area - #391

Merged
tuhaihe merged 1 commit into
apache:mainfrom
TomShawn:ai-refine
Aug 5, 2026
Merged

Docs: refine docs layout to widen content area#391
tuhaihe merged 1 commit into
apache:mainfrom
TomShawn:ai-refine

Conversation

@TomShawn

@TomShawn TomShawn commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

On a 16" screen the article column rendered at only ~760px because the docs pages inherited the 1200px --global-main-width shared with the marketing pages, leaving wide empty gutters on both sides while the sidebar, TOC and article fought over what was left.

Docs pages now use the full viewport, capped at 1920px so lines stay readable on ultra-wide screens. The TOC moves from a percentage-based col--3 to a fixed 288px column, so every remaining pixel goes to the article instead of inflating the TOC on large screens. The article column grows to fill whatever is left.

This also aligns two stale breakpoints (1440px) in the DocItem and DocRoot layouts with the 1280px breakpoint design-style.scss already uses to hide the TOC. Between 1280px and 1440px the TOC was rendered next to an article still claiming 100% width, which squeezed the TOC down to ~185px.

Measured article width at 1728px viewport: 760px -> 921px.

Current:
image

Refined:
image

closes: #ISSUE_Number


Change logs

Describe your change clearly, including what problem is being solved or what document is being added or updated.

Contributor's checklist

Here are some reminders before you submit your pull request:

On a 16" screen the article column rendered at only ~760px because the
docs pages inherited the 1200px `--global-main-width` shared with the
marketing pages, leaving wide empty gutters on both sides while the
sidebar, TOC and article fought over what was left.

Docs pages now use the full viewport, capped at 1920px so lines stay
readable on ultra-wide screens. The TOC moves from a percentage-based
col--3 to a fixed 288px column, so every remaining pixel goes to the
article instead of inflating the TOC on large screens. The article
column grows to fill whatever is left.

This also aligns two stale breakpoints (1440px) in the DocItem and
DocRoot layouts with the 1280px breakpoint design-style.scss already
uses to hide the TOC. Between 1280px and 1440px the TOC was rendered
next to an article still claiming 100% width, which squeezed the TOC
down to ~185px.

Measured article width at 1728px viewport: 760px -> 921px.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@TomShawn
TomShawn requested a review from tuhaihe August 4, 2026 05:49
@TomShawn TomShawn added documentation Improvements or additions to documentation javascript Pull requests that update javascript code labels Aug 4, 2026
@tuhaihe
tuhaihe merged commit 68e3864 into apache:main Aug 5, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation javascript Pull requests that update javascript code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants