A big problem with this documentation is that it's not with the rest of the docs and isn't found in search on golang.org. The docs provide enough to make modul

A big problem with this documentation is that it's not with the rest of the docs and isn't found in search on golang.org. The docs provide enough to make modules work but are far from excellent in terms of docs. These docs also highlight things about how the Go team thinks. For example, if a project is versioned at v2 or later they recommend incrementing the major version of your code when adopting modules. Instead of modules being support tooling for the app it's designed and thought of as important as a major version change.