[Migration tooling] Example blocks & Sidebars

[bmorelli25]

Example blocks

Example blocks are treated like admonitions in migration tooling.

Sidebars

Sidebars are rendered as admonitions.

[Mpdreamz]

Sidebars: See also #4

We did support this for a while to shift/float content to the right. See also https://developer.mozilla.org/en-US/docs/Web/HTML/Element/aside for more information on <aside> html tag.

I don't think we need it today as discussed on #4

Example blogs:

Do we have examples for these in the our documentation? What are they generally used for?

Sorta related are the #30 and #31 directives which are hyper specialized boxes we opted not to support from Myst (for now).

I wonder if these are really always genuine admonitions.

[bmorelli25]

I wonder if these are really always genuine admonitions.

I think you nailed it with this statement.

Migration tooling converts all examples (here's an example of an example block for you (step4)) to TIP admonitions. From there, writers will have to figure out if that's the correct admonition type to use or if an admonition isn't needed at all.