go icon indicating copy to clipboard operation
go copied to clipboard

x/website: define the term `root module` in ref/mod

Open perillo opened this issue 2 years ago • 5 comments

The documentation for workspaces introduced a new term root module in the Go Module Reference. The term is used in the glossary for workspace, but it is never defined.

perillo avatar Apr 08 '22 08:04 perillo

The article https://go.dev/blog/get-familiar-with-workspaces uses the term root module in the first paragraph, but later use the term main module in

  • use: adds a module on disk to the set of main modules in a workspace [...]

This is a bit confusing.

perillo avatar Apr 08 '22 08:04 perillo

I think the docs mean to use "main module" consistently; there might have been a mistake due to the similar concept that is "root package".

mvdan avatar Apr 08 '22 10:04 mvdan

cc @matloob @bcmills

cherrymui avatar Apr 08 '22 14:04 cherrymui

Yes, it would be correct to use “main module” instead, since https://go.dev/ref/mod#minimal-version-selection also uses the term “main modules”:

MVS starts at the main modules (special vertices in the graph that have no version) and traverses the graph

bcmills avatar Apr 12 '22 17:04 bcmills

Change https://go.dev/cl/421895 mentions this issue: _content: consistently use main module instead of root module

gopherbot avatar Aug 06 '22 14:08 gopherbot