{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img"]},"type":"markdown"},"seo":{"title":"Project 71: Redoc 3 test drive","llmstxt":{"hide":true}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"project-71-redoc-3-test-drive","__idx":0},"children":["Project 71: Redoc 3 test drive"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"which-way-was-smoothest-and-which-docs-page-failed-you-where-exactly-did-it-lose-you","__idx":1},"children":["Which way was smoothest, and which docs page failed you? Where exactly did it lose you?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["!important"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"was-the-documentation-clear-enough-to-run-each-way-without-asking-anyone-name-the-page-and-the-sentence-you-would-rewrite","__idx":2},"children":["Was the documentation clear enough to run each way without asking anyone? Name the page and the sentence you would rewrite."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Yes, except the theming page. It tells you to set the variables on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[":root"]},". That never works, because"," ","Redoc adds its own ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[":root"]}," styles later and they win. It should say to set them on the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redoc"]}," element."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"did-any-deep-link-miss-its-spot-or-lose-its-state-after-a-reload","__idx":3},"children":["Did any deep link miss its spot, or lose its state after a reload?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/screenshot-2026-09-21-at-2.19.19âpm.1320a9c17ac8c8e7303a075c3920ea0508fb5160d56060b0d29b06a7bfc647cb.b1b1afec.png","alt":"Screenshot 2026-09-21 at 2.19.19 pm.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["2"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/screenshot-2026-09-21-at-2.20.48âpm.77db34e23a731a3c1bf12595416bffb08d16f41daf718d0829156949211fced4.b1b1afec.png","alt":"Screenshot 2026-09-21 at 2.20.48 pm.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"did-any-search-result-mislead-you-or-hide-something-you-could-see-on-the-page","__idx":4},"children":["Did any search result mislead you, or hide something you could see on the page?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No. Search worked well."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"in-the-sync-which-check-failed-or-surprised-you","__idx":5},"children":["In the sync, which check failed or surprised you?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["main"]}," is green. The base branch is out of date."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"what-made-you-smile","__idx":6},"children":["What made you smile?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pnpm run stage:ce"]}," worked first try. Our comment was there, the marked block and its markers were gone."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"what-did-you-find-confusing","__idx":7},"children":["What did you find confusing?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Finding the right CSS variable. They point at each other, so you end up digging through the rendered"," ","CSS."]}]},"headings":[{"value":"Project 71: Redoc 3 test drive","id":"project-71-redoc-3-test-drive","depth":1},{"value":"Which way was smoothest, and which docs page failed you? Where exactly did it lose you?","id":"which-way-was-smoothest-and-which-docs-page-failed-you-where-exactly-did-it-lose-you","depth":4},{"value":"Was the documentation clear enough to run each way without asking anyone? Name the page and the sentence you would rewrite.","id":"was-the-documentation-clear-enough-to-run-each-way-without-asking-anyone-name-the-page-and-the-sentence-you-would-rewrite","depth":4},{"value":"Did any deep link miss its spot, or lose its state after a reload?","id":"did-any-deep-link-miss-its-spot-or-lose-its-state-after-a-reload","depth":4},{"value":"Did any search result mislead you, or hide something you could see on the page?","id":"did-any-search-result-mislead-you-or-hide-something-you-could-see-on-the-page","depth":4},{"value":"In the sync, which check failed or surprised you?","id":"in-the-sync-which-check-failed-or-surprised-you","depth":4},{"value":"What made you smile?","id":"what-made-you-smile","depth":4},{"value":"What did you find confusing?","id":"what-did-you-find-confusing","depth":4}],"frontmatter":{"seo":{"title":"Project 71: Redoc 3 test drive"}},"lastModified":"2026-09-21T12:58:33.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/debrief/project-71","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}