The Official Go Modules Documentation
github.com
github.com
The v2 story is just broken. It is nice to have a possibility to have multiple versions of the same package in this 0.1% of projects. The cost of it is anguish and frustration for 99.9%.
On the other hand I am seeing libraries teetering on the border of introducing breaking changes to point releases, or holding back progress, just to avoid going v2.
Nonsense
+incompatible