godotengine / godotengine/godot-docs

Discussion: Dealing with Disambiguation in the Godot Manual

Open
#10,536 2 comments 0 reactions 0 assignees View on GitHub
area:manual content:new page discussion
Dominant language
reStructuredText
Stars
5.7k
Forks
3.8k
Avg merge
1d 20h
Merged PRs (30d)
25

Description

This has popped up in my mind when I was thinking about [enhancing the documentation of Addons and Plugins](https://github.com/godotengine/godot-docs/issues/10529#issuecomment-2604636307)

I think the difference between plugins, addons, gdextension, tools and modules may not really be clear to many users and could need a disambiguation wiki page.

A good place in my opinion would be a dedicated disambiguation section in the manual. However that would 100% leave the scope of just enhancing the plugin/addon documentation. I think it would also need more than just one use-case to warrant its existence.

Hence I am opening this discussion to collectively think about:
1. are there other areas in Godot that would benefit from disambiguation?
2. what is the best way to implement that?

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.