Update Node.xml: specify that normal processing happens in tree order
For _ready it was already spelled out in a few places that it happens bottom to top (child first parent later).
I found it hard to find information about the order of _process and _physics_process, the only place I found was here in the tutorial for SceneTree which someone linked me to.
Thank you for fixing the typo!
I found that my suggested change is incomplete, for _process and _physics_process, there are the properties process_priority and process_physics_priority, respectively.
Edit: When Priority is changed inside a process callback, the order will be wrong for this one iteration, then correct at the next iteration. That should be fine.
I'd say this is a bit too complex to describe in the class docs here, and should be a detailed page in the docs instead, and linked to
Related:
- https://github.com/godotengine/godot-docs/issues/9305
I've removed it from the top paragraph since as you said that would get pretty long, mentioning both priority and tree order.
Personally I would prefer to still add it to the actual method documentation, if only for parity with _ready, but the call is obviously yours.
To be fully honest I don't have the knowledge, time, or motivation to create the full processing diagram requested in the issue.
The commits need to be squashed into one before this can be merged. See here for one explanation on how to do do that.
Thanks!