godotengine / godotengine/godot-docs

Improving `Overview of Godot's key concepts`

Open
#9,856 1 comment 0 reactions 0 assignees View on GitHub
area:getting started enhancement
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.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.