bevyengine / bevyengine/bevy-website
0.15 release notes: Bubbling observers section is confusing
- Dominant language
- JavaScript
- Stars
- 249
- Forks
- 450
- Avg merge
- 16h 20m
- Merged PRs (30d)
- 6
Description
https://bevyengine.org/news/bevy-0-15/#bubbling-observers
> Virtually every pointer interaction (like mouse click) is rare (humans are slow!), and often requires a complex response.
>
> This pattern is particularly useful in UI, where unhandled interactions are often intended for the pane that contains the entity that's on top, but is also valuable for in-game interactions: clicking on a unit's sword should select the unit!
It feels like there's a missing sentence here or something. I am not understanding how the first and second paragraphs relate to each other. Also, I am taking the word "rare" to mean "doesn't happen nearly on every frame" but that leap required a bit of headscratching.
Contributor guide
Research direction
Start with the Bubbling Observers section at the linked Bevy 0.15 release-notes page and read the surrounding paragraphs. Clarify how the two paragraphs relate and what “rare” means, then verify that the section reads coherently without the reported headscratching.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 55/100