bevyengine / bevyengine/bevy-website

0.15 release notes: Bubbling observers section is confusing

Open
#1,876 0 comments 0 reactions 0 assignees View on GitHub
A-Release-Notes C-Correction S-Ready-For-Implementation
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.