Link to section: https://w3c.github.io/using-aria/#hiding-content-has-no-effect-on-accessible-name-or-description-calculation
The text preceding the first code example says, “the description will be available to assistive technology users in both states.”
It might be worth explicitly stating that this is not desirable, i.e., you don’t want the description to be available in both states. This wasn’t immediately clear to me.
For example, the code could include a comment that says something like,
<!--
IMPROPER CODE:
CSS display:none does not hide the description from AT in this situation.
-->
Link to section: https://w3c.github.io/using-aria/#hiding-content-has-no-effect-on-accessible-name-or-description-calculation
The text preceding the first code example says, “the description will be available to assistive technology users in both states.”
It might be worth explicitly stating that this is not desirable, i.e., you don’t want the description to be available in both states. This wasn’t immediately clear to me.
For example, the code could include a comment that says something like,