-
Notifications
You must be signed in to change notification settings - Fork 9.3k
Description
-
skipping
h2-h1is used for the title and thenh3for operations and schemas.h2is used only for webhooks in OpenAPI 3.1 (rendered on the same level as tags sections starting withh3) and for nested callbacks in OpenAPI 2.0/3.0 (rendered nested in operations which start withh3). The main sections should be unified to start with the same heading. -
nesting
h2inside of section starting withh3andh4- callbacks are nested within operations and start withh2, breaking the order of headings (h1→h3→h4→h2)
-
Parameters and Callbacks heading - these headings are used as buttons but have no indication that the user can switch between the Parameters and Callbacks sections or which one is chosen. It is also not possible to focus them when using tab navigation
-
tag heading - the heading is used as a button and can expand/collapse the section without any indication that it does so. We should indicate that it can be interacted with, what it does and what the current state (expanded/collapsed) is.
-
unify styling of headings - styling of headings should be the same for different components, in this case it’s
h4that is different for: cURL, request URL, server response, responses, schemas
This task covers issues originally reported in: