x/website/internal/dl: expand JSON download mode to optionally return archive and unstable releases also

[johnweldon]

Issue

The PR that resolved #23746 provided a nice JSON response on the download page https://golang.org/dl/?mode=json

However, this only provides for stable releases.

I would like to consume unstable and archive release metadata as JSON also.

Proposal

I'd like to modify https://github.com/golang/tools/blob/4d6773f/godoc/dl/server.go#L80-L88 to add a query param to include archive or unstable releases optionally.

I'm thinking https://golang.org/dl/?mode=json[&include=(all|stable|unstable|archive)]

When the include param is absent, it would default to stable which is the current behaviour already.

[agnivade]

/cc @andybons @dmitshur

[andybons]

Why not just all and stable as options? Is there a specific need for the level of granularity you specify?

[johnweldon]

All I personally need is all. Since we'd be changing the code anyway, we may want to add some query param options for other use cases but maybe that's YAGNI

[andybons]

I’m down for an all option. We can expand if needed.

[gopherbot]

Change https://golang.org/cl/155740 mentions this issue: x/tools/godoc/dl: enhance JSON download with "all" option

[gopherbot]

Change https://golang.org/cl/163741 mentions this issue: internal/dl: enhance JSON download with include=all option