diff --git a/site/src/pages/components/popover-hint.research.explainer.mdx b/site/src/pages/components/popover-hint.research.explainer.mdx
index 7e9dd7308..3957ee16b 100644
--- a/site/src/pages/components/popover-hint.research.explainer.mdx
+++ b/site/src/pages/components/popover-hint.research.explainer.mdx
@@ -7,7 +7,7 @@ layout: ../../layouts/ComponentLayout.astro
---
- [@mfreed7](https://github.com/mfreed7), [@scottaohara](https://github.com/scottaohara), [@aleventhal](https://github.com/aleventhal)
-- Last updated: October 26, 2023
+- Last updated: January 19, 2024
A followup proposal to the [original Popover proposal](https://open-ui.org/components/popover.research.explainer/), which adds several features related to building hints/tooltips.
@@ -20,6 +20,7 @@ A followup proposal to the [original Popover proposal](https://open-ui.org/compo
- [Tooltip lifecycle behaviors](#tooltip-lifecycle-behaviors)
- [Scope of this explainer](#scope-of-this-explainer)
- [Proposal: popover=hint](#proposal-popoverhint)
+- [Popover Stacks](#popover-stacks)
- [Accessibility](#accessibility)
- [Why differentiate between rich and plain hints?](#why-differentiate-between-rich-and-plain-hints)
- [A11y API support](#a11y-api-support)
@@ -46,7 +47,7 @@ It turns out, the definition of "tooltip" can be tricky. There are several defin
2. The "triggered by hover" definition: any **pop-up window/dialog**, containing **any type of content**, that **opens when a user mouse-hovers** an element.
3. The "semantic" definition: A popover containing **non-essential**, **auxiliary** information about a context element.
-Definition #1 is too limiting, and does not capture common use cases that include non-textual content. A good example is the window that appears when you hover over a username on Github:
+Definition #1 is too limiting, and does not capture common use cases that include non-textual content. A good example is the window that appears when you hover over a username on Github:

@@ -101,7 +102,7 @@ As described above, there are many behaviors associated with tooltips.
The invokers proposal covers hover/focus/etc triggering all kinds of things, including popovers, dialogs and more. It fully handles the behaviors described in sections [1](#1-triggering-a-tooltip) and [3](#3-dismissing-a-tooltip). Since that proposal is very general, and includes many non-popover use cases, it makes sense to discuss it separately.
-**Note also** that this proposal is **orthogonal** to the [invokers](https://open-ui.org/components/invokers.explainer) proposal. The behaviors described here can function on their own, via the existing `popovertarget=idref` mechanism, or even via Javascript. Of course, very much like the [Anchor Positioning](https://drafts.csswg.org/css-anchor-position-1/) feature, hint popovers will become even more powerful once the [invokers](https://open-ui.org/components/invokers.explainer) mechanism has landed. But these two features do not need to be gated on each other.
+**Note also** that this proposal is **orthogonal** to the [invokers](https://open-ui.org/components/invokers.explainer) proposal. The behaviors described here can function on their own, via the existing `popovertarget=idref` mechanism, or even via Javascript. Of course, very much like the [Anchor Positioning](https://drafts.csswg.org/css-anchor-position-1/) feature, hint popovers will become even more powerful once the [invokers](https://open-ui.org/components/invokers.explainer) mechanism has landed. But these two features do not need to be dependent on each other, or land together.
# Proposal: popover=hint
@@ -109,19 +110,30 @@ This proposal is to add one more value to the [popover attribute](https://develo
When a hint is shown, it behaves differently from other popover types such as `popover=auto` and `popover=manual` in a few ways:
-| | `popover=auto` | `popover=hint` | `popover=manual` |
-| ------------- | ------------------------- | -------------- | -------------- |
-| Light dismiss | Yes | Yes | No |
-| Force-hides: | Other `auto`s and `hint`s | Other `hint`s | Nothing |
-| Nesting: | Yes | No [*](#nesting_star) | N/A - no light dismiss |
+| | `popover=auto` | `popover=hint` | `popover=manual` |
+| ------------- | ----------------------------- | --------------------------- | ---------------------- |
+| Light dismiss | Yes | Yes | No |
+| Force-hides: | Unrelated `auto`s and `hint`s | Other `hint`s | Nothing |
+| Nesting: | Yes | [Special](#popover-stacks) | N/A - no light dismiss |
-First, hints should always be light dismissible. They are transient, supplementary information, so they should not require affirmative action to close them. Clicking or tapping outside or hitting the ESC key will close a hint.
+First, hints should always be light dismissible. They are transient, supplementary information, so they should not require affirmative action to close them. Clicking or tapping outside or hitting the ESC key (or any [close request](https://html.spec.whatwg.org/#close-request)) will close a hint.
-The second row ("Force-hides") shows that tooltip content is "secondary" to other content, so hints do not hide other non-hint popovers. An example use case for this is that there is a select list picker open, and the user is selecting from the available options. While doing that, the user mouse-hovers another element on the page to see a tooltip that might inform them about which option to pick. While the tooltip is shown, the select list picker should not be closed.
+The second row ("Force-hides") shows that tooltip content is "secondary" to other content, so hints do not hide other **non**-hint popovers. An example use case for this is that there is a `