x/website: merge module doc changes as part of Go 1.16 release

[ALTree]

1.16 introduces a retract directive. The new directive is not mentioned in the Go Modules Reference. The CL adding the doc will need to be merged before the 1.16 release (currently has a merge conflict).

In 1.16, go install will accepts arguments with version suffixes (go install pkg@version). The CL adding the relevant doc will need to be merged before the 1.16 release (currently has a merge conflict, and unresolved comments).

Filing an issue just to be sure this is on someone's radar.

cc @dmitshur @bcmills

[dmitshur]

Thanks. If I understand correctly, @jayconrod is planning to submit that CL stack as part of the Go 1.16 release, and we will coordinate the timing as needed. The merge conflict is because it’s a CL in the middle of a stack, I don’t think it’s a problem. The comments will need to be addressed.

Also CC @rsc, @stevetraut as FYI.

[ALTree]

Great! Thanks for confirming. I was trying to find documentation for the new retract directive and I was somewhat surprised I couldn't find any in tip.golang.org. But I guess with the new x/website setup website changes will get committed at the very last moment from now on(?)...

[dmitshur]

changes will get committed at the very last moment from now on(?)

For Go 1.16, yes, but that isn't a great experience and we'll look about improving it in the future (perhaps with a branch, or something else). CL 291693 goes a long way to reduce the tight coupling between the main repo and x/website, which will give us good options to work with.

[dmitshur]

I left a comment on CL 284812, the first unmerged CL in that stack, noting that it's safe to start landing it now. CC @jayconrod.

[ALTree]

Fixed by merging the aforementioned CL stack.