Update Plugin Handbook with a reason why text-domains must be identical to the WordPress Org Repo Slug of the plugin #1001
Labels
developer documentation (DevHub)
Improvements or additions to developer documentation
plugins
Issues for Plugin Developer Handbook
[Status] In progress
Issue is in progress
Issue Description
In WP there are 2 details about text domain that often get missed:
URL of the Page with the Issue
Some of it is talked about here but might profit from some add-on details
Why is this a problem?
Well, it just comes up very often that devs or users want to use $var (and then one needs to inefficiently google for the "reason why not"), and it is also not very prominently documented that the text-domain must match the WP Org Slug.... which is truly confusing and even I as a Plugin dev, discovered this only after the fact.
It is confusing because in a WP Plugin there are several "slugs":
best is, all these just match.... but this is NOT required. Required is that the repo slug and the text-domain match and one can have custom repo urls, even if they usually get automatically generated based on... the main plugin file name? Duh, see, I forgot.
Suggested Fix
@theMikeD suggested he will look at some possible ways to add specifically the "why" to the doc.
The text was updated successfully, but these errors were encountered: