docs: improve usage of :::note
(backport #17132)
#17134
Merged
:::note
(backport #17132)
#17134