IMO it should be sufficient to warn in the release notes if it's experimental.
Actually should also be noted in README so it shows on the front of github and in the docs that tell you about using GIR (you do have those?) in big flashing orange and purple letters.
--- You are receiving this because you are subscribed to this thread. Reply to this email directly or view it on GitHub: https://github.com/geany/geany/pull/1112#issuecomment-230468949