Added a section on loading/instancing and child-adding Scenes in GDScript since this is not covered by the Instancing tutorial (which only deals with the GUI way).
I went over the basic gdscript documentation and tried to clarify as well as restructure it to be a little clearer for me as a newcomer to the language. Some of the changes:
- I added external wikipedia references to some concepts.
- I grouped all Array types (`IntArray` etc) as a list under the `Array` heading since these are arguably just special cases of the general Array structure. This also lead to the dictionary not being mixed up with arrays in the text.
- There are two syntaxes for dictionaries (: and =), I gave them comparable examples since it seems clear they are analogous).
- I gathered all the various peculiarities of Functions and function references in one place. Note that the function-referencing section needs the eye of someone more experienced with GDScript to make sure I didn't messed up. I think there is still some confusion about just when `class.function` syntax works and when it does not (when `call` or `funcref` are necessary).
- I removed a lot of same-level headings, for example the various aspects of Classes as sub-headings to the Classes heading. My impression is that this makes it easier to track where one is.
- Did some overall rephrasing and slimming of filler text. This was largely colored by where I felt the text unclear to my current level of understanding. An experienced eye is needed to verify so that the changes are factually ok.
Example code blocks will not introduce auto-line breaks, which will mess up PDFs and give annoying horizontal scroll bars in example code. Refactored all comments in gdscript.rst to be horizontally shorter for this reason. Also made some rewording for clarity.
Looks like I had kept my testing imports for the "advanced topics"
and forgot to replace them by the files from the newer snapshot.
We should now have 100% of the OP contents (+ what was added only
in this repo).
Pawel Kowal