Improve documentation for return value of Packed*Array.resize

[Monochrome-debug]

Changed the documentation to specify the return value of the resize() function because of this issue from the godot docs repo.

[Mickeon]

The Array equivalent of this method already has a more suitable way of describing this (since #69451):

Returns [constant OK] on success, or one of the other [enum Error] constants if this method fails.

I would suggest copying it. I don't think the way it is described in this PR (as of writing this) is clear or concise.

[Monochrome-debug]

Should we merge now?

[AThousandShips]

LGTM

[akien-mga]

For now this would be fine, but it could be worth looking into:

• Properly describing why resize can fail and with what error code. From a quick look at CowData::resize, it can return ERR_INVALID_PARAMETER is size is negative, or ERR_OUT_OF_MEMORY if allocations fail.
• Why don't these methods return Error instead of int? That would make it explicit that it's OK on success and not-OK otherwise.

[AThousandShips]

The lack of Error is due to a limitation in the binding system for built-in types, unsure if tracked anywhere, but it's due to metadata not being passed (same reason as methods with int arguments are bound as int64_t in GDExtension for String for example)

Related:

• string length type inconsistency godot-cpp#1338
• String::num_uint64() signature is incorrect godot-cpp#1014

[akien-mga]

Properly describing why resize can fail and with what error code. From a quick look at CowData::resize, it can return ERR_INVALID_PARAMETER is size is negative, or ERR_OUT_OF_MEMORY if allocations fail.

I went ahead and documented this, and made things further consistent with Array.

[akien-mga]

Thanks! And congrats for your first merged Godot contribution 🎉