Make config options visible instead of buried in Expandables - #398
Open
tillrohrmann wants to merge 1 commit into
Open
Make config options visible instead of buried in Expandables#398tillrohrmann wants to merge 1 commit into
tillrohrmann wants to merge 1 commit into
Conversation
tillrohrmann
force-pushed
the
config-reference-flatten
branch
2 times, most recently
from
September 1, 2026 21:02
7924a21 to
eaeb9fc
Compare
Reading this page meant clicking: 56% of options sat behind an Expandable labelled "Properties", and metadata-client and network-error-retry-policy were hidden entirely. Sub-sections now get their own headings, so 85% of options are on the page with no interaction and the sidebar reaches worker.invoker rather than stopping at worker. Tagged enums gave no clue you had to pick one. The `type` field is now a normal option listing the values it accepts, and each value's extra options sit in a tab instead of a collapsed box, which is what "pick exactly one" looks like. Each key is rendered once. Shared options were repeated inside every variant, which had metadata-client.backoff-policy.type appearing nine times. Expandables drop from 49 to 2, with no option added or lost. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
tillrohrmann
force-pushed
the
config-reference-flatten
branch
from
September 1, 2026 21:08
eaeb9fc to
d0a5af7
Compare
tillrohrmann
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Reading this page meant clicking. Measured before this change:
workerwas 13 visible against 91 hidden, andmetadata-clientandnetwork-error-retry-policywere hidden entirely.Sub-sections get their own headings. 85% of options are now on the page with no interaction, and the sidebar reaches
worker.invokerrather than stopping atworker. Not done by expanding the boxes by default:Expandablehas nodefaultOpen, so that would mean forcingopenfrom JS, which fights the component and permanently corrupts Mintlify's TOC scroll-spy.Tagged enums say how to select them. The
typefield is now a normal option listing the values it accepts, and each value's extra options sit in a tab instead of a collapsed box. A variant whose only field is the discriminator gets no container at all.Each key is rendered once. Shared options were repeated inside every variant, which had
metadata-client.backoff-policy.typeappearing nine times.Expandables drop from 49 to 2, with no option added or lost — 336 distinct keys before and after.
Stack created with GitHub Stacks CLI • Give Feedback 💬