godotengine / godotengine/godot-docs
UI Intro page uses the word 'Container' in possibly confusing ways
- Dominant language
- reStructuredText
- Stars
- 5.7k
- Forks
- 3.8k
- Avg merge
- 1d 20h
- Merged PRs (30d)
- 25
Description
**Your Godot version:**
3.2.3
**Issue description:**
There are several instance of misleading wording using the word `Container` in this page. Midway through the page, it is established that containers will override aspects of children. 2 Sections later this word is now being used to describe `Control` nodes generically as `Containers`, and doing things a Container will override.
[Anchors are relative to the parent container](https://docs.godotengine.org/en/stable/getting_started/step_by_step/ui_introduction_to_the_ui_system.html#anchors-are-relative-to-the-parent-container) <-- this is incredibly misleading as a title itself, as Containers override Anchors.

All of the data shown in this image is overridden by a `Container`, but that word is still used in it, blurring the meaning of `Container` as a concept that needs to be taught in this page.
> "Margins update automatically when you move or resize a control node. They represent the distance from the control node's edges to its anchor, which is relative to the parent control node or container"
"*relative to the parent control node **or container***" but a container overrides child margins, so this is partially a false statement.
The liberal use of the word **Container** to generalize `Control` or `Rect2` at times in this introductory page seems to blur the concept of `Container` being a subset of `Control` and overriding much of how `Control`s typically work.
**URL to the documentation page (if already existing):**
https://docs.godotengine.org/en/stable/getting_started/step_by_step/ui_introduction_to_the_ui_system.html
~~#EDIT: noticing late that there's a 3.3 version in the docs that fixes this area, so this can probably be closed? Though I'm not sure if having it noted only to 3.3 while the current version is still 3.2 and people might mistakenly reference that page still (which was the impetus for this post, and still directed to by stable apparently).~~
#EDIT2: the update i was told of was this section being removed in the latest docs in favor of a different write up, i was mistaking 2 pages for each other thinking one had updated this already
Contributor guide
No contributing guide indexed for this repository
Assessment
This issue has not been assessed yet.