-
-
Notifications
You must be signed in to change notification settings - Fork 4.1k
Open
Labels
A-ECSEntities, components, systems, and eventsEntities, components, systems, and eventsC-DocsAn addition or correction to our documentationAn addition or correction to our documentation
Description
How can Bevy's documentation be improved?
There are a few important patterns that can be used for writing reusable, more abstrated Bevy code.
- Generic systems (already has an example).
- Methods on component and resource types.
- The SystemParam derive.
- The WorldQuery derive.
The second often makes beginners nervous (seperate your data and logic!!), while the latter two are hard-to-discover, full of irrelevant unsafe and tricky to figure out how to use.
We should have an example demonstrating how and why to use these tools, in a moderately realistic setting. For methods, I'd demonstrate encapsulation, maybe with a nice validated setter pattern.
This should be covered in more depth in the book, but for now I think a short example would serve as a nice breadcrumb.
Additional Context
bevyengine/rfcs#68 will make working with and defining methods on the WorldQuery
derive much nicer.
ItsDoot, Retrodad0001, LoopyAshy, partnano, joseph-gio and 1 more
Metadata
Metadata
Assignees
Labels
A-ECSEntities, components, systems, and eventsEntities, components, systems, and eventsC-DocsAn addition or correction to our documentationAn addition or correction to our documentation