Reword warning about extension compatibility in README

GDExtension has limited forwards compatibility available since Godot 4.1,
so the warning, while still relevant, can be made less prominent.
pull/1588/head
Hugo Locurcio 2024-09-17 01:48:46 +02:00
parent 4131b7f95f
commit 4de929e289
No known key found for this signature in database
GPG Key ID: 39E8F8BE30B0A49C
1 changed files with 15 additions and 13 deletions

View File

@ -49,20 +49,22 @@ Godot version.**
## Compatibility ## Compatibility
> [!WARNING] Due to the intricacies of working with [ABIs](https://en.wikipedia.org/wiki/Application_binary_interface),
> compatibility with GDExtension is not as strictly guaranteed as with GDScript or C#.
> The GDExtension API is brand new in Godot 4.0, and is still Current limitations in the GDExtension system may also require compatibility-breaking changes
considered in **beta** stage, despite Godot 4.0 itself being released. to be lifted. This applies to both the GDExtension interface header, the API JSON, and this
>
> This applies to both the GDExtension interface header, the API JSON, and this
first-party `godot-cpp` extension. first-party `godot-cpp` extension.
>
> Some compatibility breakage is to be expected as GDExtension and `godot-cpp` In practice, this means that **GDExtension compatibility can occasionally break across minor Godot releases**.
> get more used, documented, and critical issues get resolved. See the Be sure to read the [Migrating](https://docs.godotengine.org/en/latest/tutorials/migrating/index.html)
> [Godot issue tracker](https://github.com/godotengine/godot/issues?q=is%3Aissue+is%3Aopen+label%3Atopic%3Agdextension) guide for your current Godot version when running into issues with installing GDExtensions.
> and the [godot-cpp issue tracker](https://github.com/godotengine/godot-cpp/issues)
> for a list of known issues, and be sure to provide feedback on issues and PRs Some compatibility breakage is to be expected as GDExtension and `godot-cpp`
> which affect your use of this extension. get more used, documented, and critical issues get resolved. See the
[Godot issue tracker](https://github.com/godotengine/godot/issues?q=is%3Aissue+is%3Aopen+label%3Atopic%3Agdextension)
and the [godot-cpp issue tracker](https://github.com/godotengine/godot-cpp/issues)
for a list of known issues, and be sure to provide feedback on issues and PRs
which affect your use of this extension.
## Contributing ## Contributing