Skip to content

Docs flush layout - #473

Merged
codingfrog27 merged 6 commits into
mainfrom
docs-flush-layout
Oct 8, 2026
Merged

codingfrog27 merged 6 commits into
mainfrom
docs-flush-layout

Conversation

@codingfrog27

@codingfrog27 codingfrog27 commented Oct 5, 2026 •

Copy link
Copy Markdown
Contributor

Doc layout changes

Changes the layout of the documentation pages, with the aim of improving user experience. Along with some extra functionality. docusaurus and tensorflow's documentation were used (among others) as inspiration/reference point.

I've opted to make seperate PR's for the breakout utility.

layout Changes made

  • removed the old inner cap so the layout can now span the whole window
  • Moved sidebar to sit flush on the left side of the page
    • also added a subtle border to it.
    • Nav and fooder now span the same width as the docs layout (unaffected for non doc pages)
  • Moved the TOC to sit next to the content, and centered both it and the content together
  • TOC now appears from 1080 px so it's still viewable from vertical monitor
  • TOC is now also toggle-able
  • Added a cap to line length in line with conventions.

functionality

  • When there's not enough horizontal space to show the sidebar, the button to expand the overlay for it now tracks among the page
  • TOC text now wraps if titles dont fit on the page
  • TOC now has imrpoved current section highlighting, beforehand the first and last 2 sections would not be highlighted if the sections were too short
  • Highlighting should also work on safari now (untested)

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 5, 2026 •

Copy link
Copy Markdown

Deploying labs-browserpod-previews with  Cloudflare Pages  Cloudflare Pages

Latest commit: 8c998fb
Status: ✅  Deploy successful!
Preview URL: https://4c9ee4e8.labs-browserpod-previews.pages.dev
Branch Preview URL: https://docs-flush-layout.labs-browserpod-previews.pages.dev

View logs

@codingfrog27
codingfrog27 marked this pull request as ready for review October 6, 2026 18:56
Comment thread packages/astro-theme/rehype-breakout-images.ts Outdated
@codingfrog27
codingfrog27 merged commit 9b54771 into main Oct 8, 2026
7 checks passed
@codingfrog27
codingfrog27 deleted the docs-flush-layout branch October 8, 2026 12:51
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.

2 participants