We'll be redesigning pkg.go.dev based on feedback received over the last year. This is the third in a series of issues about plans for the pkgsite/design-2020 milestone. Comment below with any feedback or suggestions related to this issue!
There are multiple ways in which “latest” can be defined for a path. In order to better express various relationships, we will use the following terms:
Series: 1 or more modules that are major versions of each other
I guess this is fine as a fallback, if v3/syntax doesn't exist as a package. But if the same sub-package exists in the new major version of the module, I think we should directly link there. Otherwise I have to go into "directories" and find it again.
These changes are live on pkg.go.dev, and all related issues have been addressed except flag packages that are no longer present in the latest version of the containing module, which is tracked at #37631.