Skip to content

site: Fix rolling releases page - #30657

Closed
armandomontanez wants to merge 3 commits into
bazelbuild:masterfrom
armandomontanez:armando/fix-rolling-releases
Closed

site: Fix rolling releases page#30657
armandomontanez wants to merge 3 commits into
bazelbuild:masterfrom
armandomontanez:armando/fix-rolling-releases

Conversation

@armandomontanez

Copy link
Copy Markdown
Contributor

Fixes the broken https://bazel.build/release/rolling page.

RELNOTES: None

@armandomontanez
armandomontanez marked this pull request as ready for review August 10, 2026 21:43
@github-actions github-actions Bot added the awaiting-review PR is awaiting review from an assigned reviewer label Aug 10, 2026
@armandomontanez

Copy link
Copy Markdown
Contributor Author

The mixed dark/light mode looks bad, but at least the page loads with this.

@bazel-docs-pr-commenter

bazel-docs-pr-commenter Bot commented Aug 10, 2026

Copy link
Copy Markdown

✅ Bazel docs preview is ready!

Preview URL: https://bazel-pr-30657.mintlify.app/

Updated for 70deb6ba71c031ec9f1d7a3daba560a462c3de66

copybara-service Bot pushed a commit that referenced this pull request Aug 17, 2026
#30702)

## Summary

Mintlify renders hand-authored MDX as JSX. HTML-style `style="property: value"` attributes are not valid in MDX and cause pages to fail with HTTP 500 errors or be silently excluded from the site build.

This change converts all inline `style="..."` attributes to JSX object form `style={{...}}`, with CSS property names in camelCase and values as strings—matching the approach in #30657.

**Root cause:** MDX expects JSX-style objects for inline styles, not HTML string attributes.

**Example (from `docs/release/rolling.mdx`):**

Before:
```html
<iframe src="..." style="height: 3000px; width: 100%" />
```

After:
```jsx
<iframe src="..." style={{height: "3000px", width: "100%", border: "none"}} />
```

## Affected pages (unversioned + all `docs/versions/*/` copies)

- `docs/configure/attributes.mdx`
- `docs/docs/configurable-attributes.mdx`
- `docs/release/rolling.mdx`
- `docs/external/mod-command.mdx`
- `docs/external/migration_tool.mdx`
- `docs/contribute/search.mdx`

**66 files** updated (6 top-level pages + versioned mirrors where those paths exist).

## Proof (post-fix excerpts)

`docs/release/rolling.mdx`:
```jsx
<iframe src="https://releases.bazel.build/rolling.html" style={{height: "3000px", width: "100%", border: "none"}} ></iframe>
```

`docs/configure/attributes.mdx`:
```jsx
<tr style={{background: "#E9E9E9", fontWeight: "bold"}}>
```

Fixes #30658
Fixes #30668

## Test plan

### Unit / build
- [x] No remaining `style="` in targeted `.mdx` paths (verified by conversion script)

### Mintlify preview
Preview: https://bazel-pr-30702.mintlify.app/

| Page | Before (production) | Preview check |
|------|---------------------|---------------|
| `/configure/attributes` | HTTP 500 (#30668) | [ ] HTTP 200, styled table renders |
| `/release/rolling` | excluded from build (#30658) | [ ] iframe loads rolling releases index |
| `/external/mod-command` | excluded | [ ] side-by-side SVG layout renders |
| `/external/migration_tool` | excluded | [ ] flex-wrap diagram layout renders |
| `/contribute/search` | excluded | [ ] filter reference table renders |
| `/docs/configurable-attributes` | excluded | [ ] styled table renders |

- [x] Preview deployed (bazel-docs bot comment)
- [x] `/configure/attributes` — HTTP 200, Playwright screenshot captured
- [x] `/release/rolling` — HTTP 200, Playwright screenshot captured
- [ ] Remaining pages spot-checked in preview

Closes #30702.

PiperOrigin-RevId: 966209949
Change-Id: Ieb8c1d6db75561df20a4737e4ea35000deb99937
@iancha1992 iancha1992 added team-Documentation Documentation improvements that cannot be directly linked to other team labels team-OSS Issues for the Bazel OSS team: installation, release processBazel packaging, website labels Aug 19, 2026
@armandomontanez

Copy link
Copy Markdown
Contributor Author

Fixed by Alex's PR

@github-actions github-actions Bot removed the awaiting-review PR is awaiting review from an assigned reviewer label Aug 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

team-Documentation Documentation improvements that cannot be directly linked to other team labels team-OSS Issues for the Bazel OSS team: installation, release processBazel packaging, website

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants