x/pkgsite: subdirectories are missing for nested modules

[tschaub]

What is the URL of the page with the issue?

https://pkg.go.dev/cloud.google.com/go?tab=subdirectories

What is your user agent?

Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.113 Safari/537.36

Screenshot

What did you expect to see?

I was looking for a link to the storage package. This is listed on the godoc.org as a subdirectory.

I don't see a link to the same under the subdirectories tab from pkg.go.dev.

What did you see instead?

The list of subdirectories does not include storage.

[julieqiu]

Thanks for the feedback! The reason storage is not listed there is because cloud.google.com/go/storage is a nested module:
https://github.com/googleapis/google-cloud-go/blob/v0.56.0/storage/go.mod

This means that it is not a subdirectory of cloud.google.com/go. When you download cloud.google.com/go via proxy.golang.org (https://proxy.golang.org/cloud.google.com/go/@v/v0.56.0.zip), you will notice that it is not there.

We understand that this is confusing from a UI perspective and plan to address it in the upcoming round of design changes.

/cc @fflewddur @Joanne881107

[tschaub]

Thanks for the explanation, @julieqiu. I see that the old documentation is actually misleading in this case.

I wonder if it would help if the UI were explicit about packages and nested modules instead of using "subdirectories" to describe these things. I don’t know if "nested" is a formal class of modules, but it would help clarify what you get when installing a module (packages) vs. what you need to install separately (modules that may share part of the same path).

[gopherbot]

Change https://golang.org/cl/253742 mentions this issue: internal: create GetNestedModules function in DataSource

[AceroM]

Hey there! We’re planning to add nested modules to the bottom of the subdirectories page. For example, https://pkg.go.dev/cloud.google.com/go?tab=subdirectories will show:

[gopherbot]

Change https://golang.org/cl/254018 mentions this issue: internal/frontend: add NestedModules field to Directory struct