godotengine / godot-docs

Godot Engine official documentation
https://docs.godotengine.org
Other
3.87k stars 3.16k forks source link

Control class page doesn't mention ".release_focus()" in intro #9452

Open skeddles opened 4 months ago

skeddles commented 4 months ago

Your Godot version: 4.2.1 Issue description: Maybe this isn't meant to be all-encompassing, but this page says " Control nodes lose focus when another node grabs it, or if you hide the node in focus.", which doesn't acknowledge the existence of ".release_focus()" which also makes the node node focus.

URL to the documentation page (if already existing): https://docs.godotengine.org/en/stable/classes/class_control.html

aGuyWhoMadeGames commented 4 months ago

The class reference is actually automatically generated from the doc/classes directory of the main Godot repo, so it will need to be modified there.

AThousandShips commented 4 months ago

This might be one that's relevant for the intro, but I think the description is very verbose as is, I don't think adding new information to it will necessarily help as it risks just getting lost in everything there

skeddles commented 2 months ago

then perhaps just wording it to make them sound like examples and not a complete list?

like

Control nodes can lose focus for multiple reasons, such as when another node grabs it, or if you hide the node in focus.