ReadTheDocs (RTD) is a well-known documentation hosting service, offering free builds and hosting for Sphinx and MkDocs based documentation. It’s quite popular in the Python world but not limited to it. RTD can do automatic builds of documentation in a CI/CD fashion - however this is based on a webhook that is not apparently working for the combination of RTD and Gitea.
The issue was described here Possibility to configure name of the "secret" field in POST webhook · Issue #7487 · go-gitea/gitea · GitHub and then it got closed because of some changes in the Gitea webhook implementation that are a bit obscure for me.
If I understand correctly, both RTD and Gitea have a hardcoded name for the “secret” variable and they’re not compatible, but I may be wrong.
As it stands, the only possibility to build documentation on RTD from a Gitea repository is to manually launch a build from the RTD dashboard.
This is the specific webhook configuration page, showing the “Token” parameter (the shown value has been deleted since the screenshot was taken).
Any suggestions? My repositories are hosted on Codeberg.