Components: Add more prominent documentation around popover use

[aaronrobertshaw]

What?

Highlights usage of the Popover and Tooltip components to ensure correct positioning.

Why?

When using the Tooltip component, and therefore Popover by proxy, outside the block or site editors, it isn't immediately obvious why each Popover is being rendered inline and out of position.

This was encountered during the development of new border controls where improving the docs was suggested.

How?

A prominent section relating to using Popover and ToolTip components is added to the main readme for the components package which can then be linked to from individual component docs that are likely to need Popovers rendered via a SlotFill.

Testing Instructions

Proofread edited docs.

• Component Reference
• ColorPalette README
• BorderControl README
• BorderBoxControl README

[andrewserong]

This reads well to me @aaronrobertshaw, thanks for following up with an update to the docs!

For the URLs linking the documents to each other, I was wondering if they need to be absolute paths instead so that the URLs get transformed correctly when the docs are rolled out to the block editor handbook (e.g. https://developer.wordpress.org/block-editor/reference-guides/components/)

I'm not too sure how it's all hooked together, but I see in the Button component for example that a link to the icon readme is written as [Icon](/packages/components/src/icon/README.md).

[aaronrobertshaw]

Good catch @andrewserong.

For the URLs linking the documents to each other, I was wondering if they need to be absolute paths instead

This was an oversight on my behalf. I meant to update them as I copied them in.

[andrewserong]

Thanks for the update, LGTM! 🎉

[mirka]

Great, thanks for improving the docs! The explanation is very helpful.

If this only affects consumers that are building for outside the editor, should we perhaps lead with that information? (e.g. "If you're using the component outside of the editor, make sure to...") I'm guessing the majority of wp-component consumers are building for inside the editor, so they don't need to add their own SlotFill.

[glendaviesnz]

LGTM with the suggested changes included -