Skip to content

Project 71: Redoc 3 test drive

Which way was smoothest, and which docs page failed you? Where exactly did it lose you?

The HTML element — one tag, nothing to install. The theming page failed us: we changed the CSS variables the way it says, and nothing happened until we added !important.

Was the documentation clear enough to run each way without asking anyone? Name the page and the sentence you would rewrite.

Yes, except the theming page. It tells you to set the variables on :root. That never works, because Redoc adds its own :root styles later and they win. It should say to set them on the redoc element.

Yes. Copying the link and pasting it lands in the wrong place, and so does opening it in a new window. Opening it in a new tab is fine. Only deep links — sidebar links always work. The cursor on that icon also looks wrong.

  • 1
Screenshot 2026-09-21 at 2.19.19 pm.png
  • 2
Screenshot 2026-09-21 at 2.20.48 pm.png

Did any search result mislead you, or hide something you could see on the page?

No. Search worked well.

In the sync, which check failed or surprised you?

Validate Community Source failed, so we never got a pull request. It was not our change — every team branch since 18 Sep fails the same way, and main is green. The base branch is out of date.

What made you smile?

pnpm run stage:ce worked first try. Our comment was there, the marked block and its markers were gone.

What did you find confusing?

Finding the right CSS variable. They point at each other, so you end up digging through the rendered CSS.