Rob Pike mentioned that not having enough examples was a key missing piece of Golang’s early documentation. [^1] Even examples for simplest functions helps, and it also worth to make examples executable on the web.
[^1] Rob Pike - What We Got Right, What We Got Wrong > Docs and examples