Skip to content

[v12] Remove ScopedBlocks from the docs#30809

Merged
ptgott merged 4 commits intobranch/v12from
paul.gottschling/2023-08-21-sb-v12
Aug 24, 2023
Merged

[v12] Remove ScopedBlocks from the docs#30809
ptgott merged 4 commits intobranch/v12from
paul.gottschling/2023-08-21-sb-v12

Conversation

@ptgott
Copy link
Copy Markdown
Contributor

@ptgott ptgott commented Aug 21, 2023

Backports a series of PRs removing ScopedBlocks from the documentation:

Also removes the remaining ScopedBlocks from v13 of the docs.

zmb3

This comment was marked as resolved.

ptgott added 4 commits August 24, 2023 13:14
Backports #30616

* Replace multi-line ScopedBlocks with Tabs

Contributes to #30268

The documentation scope switcher tends to confuse users, and the
ScopedBlock component hides docs content based on the scope switcher. To
help remove ScopedBlocks from the docs site, this change replaces
multi-line ScopedBlocks with Tabs components if they include variations
for different scopes.

While most multi-line ScopedBlocks function like Tabs, there are a few
edge cases, which this change addresses individually.

Note that this change does not intend to remove all ScopedBlocks that
are placed inline within a paragraph. That will be the goal of a
separate change.

* Remove more ScopedBlocks (#30623)

This builds on the work done in #30616 and contributes to #30616.
Backports #30769

In #30616, we replaced `ScopedBlocks` with `Tabs` components. This was
because most `ScopedBlocks` included variations on the same text for
multiple scopes, and replacing them with `TabItem`s was straightforward.
However, some replacements included only a single `TabItem`, which
displays awkwardly in the docs.

This change removes `Tabs` components with only one `TabItem`, replacing
them with body text.
@ptgott ptgott enabled auto-merge August 24, 2023 17:14
@ptgott ptgott force-pushed the paul.gottschling/2023-08-21-sb-v12 branch from ee8e3de to abd55c0 Compare August 24, 2023 17:14
@ptgott ptgott added this pull request to the merge queue Aug 24, 2023
Merged via the queue into branch/v12 with commit d570592 Aug 24, 2023
@ptgott ptgott deleted the paul.gottschling/2023-08-21-sb-v12 branch August 24, 2023 17:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants