x/website: canonical GOEXPERIMENT documentation
@prattmic is already working on this.
Since Aug 20, 2026.
- Dominant language
- Go
- Stars
- 139k
- Forks
- 19.9k
- PR merge metrics
- PR metrics pending
Description
Go supports a variety of different GOEXPERIMENTs for different purposes, but we have almost no documentation on what GOEXPERIMENTs are, how to use them, or what guarantees we provide. Pretty much the only documentation exists in release notes or blog posts discussing specific experiments.
https://www.alexedwards.net/blog/go-experiments-explained is a nice blog post covering GOEXPERIMENTs, which specifically notes how difficult it is to even discover what experiments exist.
Likely due to the lack of documentation, it's not very clear what level of support GOEXPERIMENTs have, or how they interact with the compatibility promise.
We should have canonical documentation covering all of this, likely something akin to https://go.dev/doc/godebug.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.