godotengine / godotengine/godot-docs
Improving `Overview of Godot's key concepts`
- Dominant language
- reStructuredText
- Stars
- 5.7k
- Forks
- 3.8k
- Avg merge
- 1d 20h
- Merged PRs (30d)
- 25
Description
**Your Godot version:**
`4.3`
**Issue description:**
Just trying to learn `GoDot`, I land on this page. I am reading:
````
In Godot, a game is a tree of nodes that you group together into scenes
````
I think - great that is very good to understand I am going lower...
```
Scenes
In Godot, you break down your game in reusable scenes.
A scene can be a character, a weapon, a menu in the user interface,
a single house, an entire level, or anything you can think of.
Godot's scenes are flexible; they fill the role of both prefabs
and scenes in some other game engines.
````
Ok that is easy to understand I guess. Lower...
````
Nodes
A scene is composed of one or more nodes.
Nodes are your game's smallest building blocks that you arrange into trees.
Here's an example of a character's nodes.
````
1. `trees` are presented to me before they are explained.
2. `Nodes` are not explained *how they glue together
3. Overall from that point everything starts to going complex and hard to understand at first look (I am not saying it's impossible to understand after more reading, but I would expect this kind of stuff to just flow naturally with my ability to understand).
4. The structure is broken, that is already too much information and it's required for me to `Noticing` something.
````
Notice how nodes and scenes look the same in the editor.
When you save a tree of nodes as a scene,
it then shows as a single node, with its internal structure hidden in the editor.
Godot provides an extensive library of base node types you
can combine and extend to build more powerful ones. 2D, 3D,
or user interface, you will do most things with these nodes.
````
**URL to the documentation page (if already existing):**
https://docs.godotengine.org/en/stable/getting_started/introduction/key_concepts_overview.html
```
Best Regards
Contributor guide
No contributing guide indexed for this repository
Assessment
This issue has not been assessed yet.