Add :applies_to: prop to admonitions

[reakaleek]

Changes

• Add :applies_to: prop handling for adminitions
• Change styling to make it work with applies_to

Screenshot

[github-actions]

🔍 Preview links for changed docs

• docs/syntax/admonitions.md

[Mpdreamz]

I do think the styling of the applies switcher is the exception.

Can discuss later though not blocking the pr.

[florent-leborgne]

Maybe due to the colored nature of admonitions but I do find the extra information less visible (recognizable might be a better word) than I'd like it to be.
I think it'd be nice if this info could still look like a badge

[reakaleek]

Maybe due to the colored nature of admonitions but I do find the extra information less visible (recognizable might be a better word) than I'd like it to be. I think it'd be nice if this info could still look like a badge

What would be the expectation for the tooltip or future popover in this case?

[colleenmcginnis]

What would be the expectation for the tooltip or future popover in this case?

I'm not a UX designer, but my gut tells me that making the badge interactive in admonitions is less problematic than with tabs/dropdowns because the admonition itself is not interactive.

[florent-leborgne]

^^ What @colleenmcginnis said.
This is something we can rationalize in the future as the cumulative docs initiative will hopefully also lead to output improvements/simplifications in that area.

[reakaleek]

@florent-leborgne @colleenmcginnis @Mpdreamz

updated in c652ce6

(including re-enabled tooltip)

[florent-leborgne]

LGTM, thanks!

[shainaraskas]

how would this work for plain admonitions?

I find myself creating notes specifically to call out availability (not notes about functionality specific to a version) e.g.:

::::{admonition} Deprecated in 6.1.

Replaced by [`elasticsearch-certutil`](/reference/elasticsearch/command-line-tools/certutil.md).
::::

would maybe work if the admonition could have an "empty" title and put just the badge there, but it wouldn't really read like a title

[colleenmcginnis]

how would this work for plain admonitions?

This is what it looks like right now (custom title Availability vs no title):

[shainaraskas]

@colleenmcginnis perhaps good enough for now? 🤷