Would be nice to have a mention of the Spatial -> Node3D rename in the godot4 docs #7337
Labels
area:class reference
Issues and PRs about the class reference, which should be addressed on the Godot engine repository
area:getting started
Issues and PRs related to the Getting Started section of the documentation
area:manual
Issues and PRs related to the Manual/Tutorials section of the documentation
enhancement
Just started playing around with Godot 4, having not touched or looked at Godot before.
Tutorial and docs are overall great, but as I started digging into stuff and googling various problems, I started finding all kinds of discussions and posts on the internet talking about doing stuff with "Spatials".
"What the heck is a spatial?" I ask myself - off to the docs. I see no class called Spatial, so I do a search, and all I find is stuff about Spatial shaders. Well that doesn't make much sense, shaders have nothing to do with what I'm looking up (usually basic "how to do weird rotations" kind of questions).
For a beginner, this is very confusing, because I keep finding people talking about how to do what I'm trying to do, but referring to things that just don't seem to exist. I was eventually able to figure it out by first just googling "godot spatial" and finding the godot 3 docs. From the description it seemed identical to Node3D, so I searched "godot spatial vs node3d" and finally came across the rename proposal, which made sense of everything.
Given how much time beginners are likely to spend googling relatively basic things, and how _un_likely the are to suspect that they might need to specify "godot 4" in their search (and you'd surely still get godot 3 answers as results), I think having some mention of this rename (especially in the tutorial) would be very helpful for other beginners like me.
At a glance, I think these might be useful pages to add a little disclaimer to:
https://docs.godotengine.org/en/stable/getting_started/introduction/key_concepts_overview.html#nodes
https://docs.godotengine.org/en/stable/getting_started/step_by_step/nodes_and_scenes.html#nodes
https://docs.godotengine.org/en/stable/tutorials/3d/introduction_to_3d.html#node3d-node
https://docs.godotengine.org/en/stable/classes/class_node3d.html
The text was updated successfully, but these errors were encountered: