Skip to content

Move GDExtension section to engine_details/engine_api.#11652

Open
Ivorforce wants to merge 1 commit intogodotengine:masterfrom
Ivorforce:gdextension-move
Open

Move GDExtension section to engine_details/engine_api.#11652
Ivorforce wants to merge 1 commit intogodotengine:masterfrom
Ivorforce:gdextension-move

Conversation

@Ivorforce
Copy link
Member

@Ivorforce Ivorforce commented Jan 22, 2026

Moves the GDExtension section to engine_details/engine_api.

Needs review / discussion, since I could imagine folks preferring how it is to what I'm proposing.

Motivation

The GDExtension section is currently located in Manual / Scripting. This section is otherwise concerned with which programming languages you can use with Godot.

While the GDExtension section is sometimes useful for godot-cpp users, it is also plenty cross linked.
However, in general it is more a documentation of what GDExtension is to the engine, and parts of it are fairly low level.

I think the engine_api section may be better suited for it. This is next to the module documentation, and indeed the two systems are somewhat similar. It's also close by the documentation for architecture and extension APIs.

@Ivorforce Ivorforce requested a review from a team January 22, 2026 11:49
@Ivorforce Ivorforce added enhancement content:organization Issues and PRs related to reorganizing the content area:manual Issues and PRs related to the Manual/Tutorials section of the documentation area:engine details Issues and PRs related to the Engine Details section of the documentation topic:gdextension labels Jan 22, 2026
@AThousandShips
Copy link
Member

You need to remove the entry in tutorials/scripting/index.rst

@dsnopek
Copy link
Contributor

dsnopek commented Jan 22, 2026

So, the idea is that the godot-cpp stuff stays under scripting and the GDExtension system stuff moves to engine details?

This makes sense to me! We can always link from the godot-cpp docs into the GDExtension system docs where we need to.

There's one place I noticed where we're linking from GDExtension to godot-cpp, that I think would make more sense the other way around: GDExtension version compatibility currently links to godot-cpp version compatibility. We probably want the more specific case (godot-cpp) referring to the more generic case (GDExtension).

@mhilbrunner
Copy link
Member

Fine by me! Needs to wait until after 4.6 release though, as we probably don't get to change those URLs in the main repository last minute that make CI unhappy.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:engine details Issues and PRs related to the Engine Details section of the documentation area:manual Issues and PRs related to the Manual/Tutorials section of the documentation content:organization Issues and PRs related to reorganizing the content enhancement topic:gdextension

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants