Skip to content

Fix mobile layout for callouts, inline code, and the docs side nav - #866

Merged
Aigeec-AWS merged 1 commit into
aws-otel:mainfrom
wisemanIV:fix-mobile-layout
Nov 2, 2026
Merged

Aigeec-AWS merged 1 commit into
aws-otel:mainfrom
wisemanIV:fix-mobile-layout

Conversation

@wisemanIV

Copy link
Copy Markdown
Contributor

Fixes mobile layout problems that showed up after #862 went live.

Changes

  • Callout boxes (BaseBox): the link button was forced onto one line. On a 390px phone screen that widened pages to 400–520px (sideways scrolling), squeezed the callout text into a two-word column, and pushed the home page menu button off screen. The button now wraps below the text on narrow screens.
  • Docs layout: the content column can now shrink, so wide content can't stretch the page past the viewport.
  • Inline code: long values such as Lambda layer ARNs now wrap instead of overflowing. This was already broken before Remove deprecated site pages and deprecate docs superseded by CloudWatch OpenTelemetry guidance #862.
  • Docs side nav (mobile): the panel was sized to 100vh - 210px, so it ended partway down the screen. It now fills the full viewport (100dvh, falling back to 100vh) and scrolls through to the last item.
  • Broken link: removed a link in the EKS add-on v0.88.0 release post to the v0.88 migration guide, which was deleted in an earlier commit.

Testing

  • Production build (gatsby build) succeeds.
  • Headless Chrome at iPhone 13 size (390px) on 17 pages, including home, introduction, collector, the EKS add-on pages, Lambda, the SDK pages and download. The page width matched the viewport on every page, and no element overflowed.
  • Side nav opened on iPhone 13, iPhone SE and Pixel 7: it fills the screen height and scrolls to the last item.
  • Desktop (1440px) layout is unchanged.
  • Scanned all 278 built pages for broken internal links; none remain.

- BaseBox callouts: let the link button wrap below the text instead of
  forcing a single line, which widened pages to 400-520px on phones and
  squeezed the callout text into a narrow column.
- Docs layout: allow the content column to shrink so wide content can
  no longer stretch the page past the viewport.
- Inline code: wrap long values (for example Lambda layer ARNs) instead
  of overflowing the screen.
- Docs side nav: fill the full viewport height on mobile. It was sized
  to 100vh - 210px, so it stopped partway down the screen.
- Remove a link to the deleted EKS add-on v0.88 migration guide from
  the v0.88.0 release post.
@wisemanIV
wisemanIV requested review from a team as code owners November 2, 2026 11:21
@olowosulu

Copy link
Copy Markdown

Looks good to me. I built it locally and checked pages at 390 to 1440px. Nothing overflows, and the side nav fills the screen and scrolls to the end. Two small things:

  1. Blog post, aws-distro-for-opentelemetry-eks-add-on-v0.88.0.mdx lines 18-19: the sentence still says the add-on-configuration page explains how to migrate from a pre v0.88.0-eksbuild.1 config, but that page has nothing on migration. I'd end it at "to learn about the new configurable values."

  2. Nit, global.js line 84: now that inline code wraps, line-height: 1 makes the wrapped lines touch (easy to see on the Lambda page on a phone). Maybe bump it to 1.4?

Also, small thing on the description: desktop isn't quite unchanged. Two callouts with long buttons now wrap at 1440px (ecs-prometheus and ecs-metrics-receiver). It looks better though, one box went from 527px to 142px tall.

@Aigeec-AWS
Aigeec-AWS merged commit b17df90 into aws-otel:main Nov 2, 2026
3 checks passed
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.

3 participants