docs(gdscript): explain the new ApiResponse

Also moving core templates to their own subdir, for clarity.

/spend 10m

Author: Goutte

modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/GdscriptClientCodegen.java

@@ -250,9 +250,9 @@ public void processOpts() {
         super.processOpts();
 
         processAdditionalProperties();
-        supportingFiles.add(new SupportingFile("ApiBee.handlebars", "core", toCoreFilename("ApiBee") + ".gd"));
-        supportingFiles.add(new SupportingFile("ApiError.handlebars", "core", toCoreFilename("ApiError") + ".gd"));
-        supportingFiles.add(new SupportingFile("ApiConfig.handlebars", "core", toCoreFilename("ApiConfig") + ".gd"));
+        supportingFiles.add(new SupportingFile("core/ApiBee.handlebars", "core", toCoreFilename("ApiBee") + ".gd"));
+        supportingFiles.add(new SupportingFile("core/ApiError.handlebars", "core", toCoreFilename("ApiError") + ".gd"));
+        supportingFiles.add(new SupportingFile("core/ApiConfig.handlebars", "core", toCoreFilename("ApiConfig") + ".gd"));
         supportingFiles.add(new SupportingFile("core/ApiResponse.handlebars", "core", toCoreFilename("ApiResponse") + ".gd"));
         supportingFiles.add(new SupportingFile("README.handlebars", "", "README.md"));
 

modules/openapi-generator/src/main/resources/gdscript/README.md

@@ -1,4 +1,4 @@
-In here are the `handlebars` templates used to generate the GDScript client.
+In here are the `handlebars` templates used to generate the `GDScript` client.
 
 All files without the `.handlebars` extension (including this very `README.md` file) are ignored.
 
@@ -28,3 +28,8 @@ Godot does not have an `Exception` (`try / catch`) mechanism, by design.
 
 Therefore, whenever there's trouble in paradise, we pass around an `ApiError` object. (a `RefCounted`, don't worry about garbage collection)
 
+
+## AoiResponse
+
+A wrapper for an Api response, used in callbacks.
+Holds the HTTP components of a Response, as well as the deserialized data (if any).