I'm a dev and I'm here to chatter. Or, more accurately, complain.
I discovered Godot recently, and as free (open source MIT licence) products go, it's amazing. Like Unity, only actually optimised properly and way more extensible. I do, however, find one major issue with it:
The documentation is nearly non-existent.
For example: it tells me I can use an object of type ImmediateGeometry to represent changing, simple geometrics in a 3D game world. So I drag one in and begin setting it up in the code.
NONE of the methods for ImmediateGeometry are documented.
It has a 'begin' method, which I assume I'll need to call first, though nothing tells me this is so. 'Begin' takes a primitive of type 'int' and a texture of type 'Texture'.
Now, I'm a fairly smart lady and a pretty good programmer. I know what a primitive is, in relation to graphics, and I obviously know what an int type is. But there is literally NO WAY for me to figure out what that int is meant to be. Number of sides? Number of points? WHO KNOWS*.
*being a smart lady, I assumed it would be a static constant in another file, which would tell the ImmediateGeometry what it should be in this instance. I was right, as far as I can tell from other people's code examples, but I still can't find a complete list of what those constants are or what they mean.