all: add or change GoDoc badge to pkg.go.dev with update-readmes.go

update-readmes.go is updated to add a pkg.go.dev badge instead of a
godoc.org badge.

The GoDoc badge is added or changed in all READMEs by running
update-readmes.go

For golang/go#42251

Change-Id: I0c49df26a6c695f938c98c9a7b26325d991b3cfb
Reviewed-on: https://go-review.googlesource.com/c/build/+/276032
Trust: Julie Qiu <julie@golang.org>
Run-TryBot: Julie Qiu <julie@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
diff --git a/autocertcache/README.md b/autocertcache/README.md
index bd5ce14..5d322c6 100644
--- a/autocertcache/README.md
+++ b/autocertcache/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/autocertcache?status.svg)](https://godoc.org/golang.org/x/build/autocertcache)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/autocertcache.svg)](https://pkg.go.dev/golang.org/x/build/autocertcache)
 
 # golang.org/x/build/autocertcache
 
diff --git a/buildenv/README.md b/buildenv/README.md
index 45de9b6..368134d 100644
--- a/buildenv/README.md
+++ b/buildenv/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/buildenv?status.svg)](https://godoc.org/golang.org/x/build/buildenv)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/buildenv.svg)](https://pkg.go.dev/golang.org/x/build/buildenv)
 
 # golang.org/x/build/buildenv
 
diff --git a/buildlet/README.md b/buildlet/README.md
index 90b01e6..efb9afe 100644
--- a/buildlet/README.md
+++ b/buildlet/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/buildlet?status.svg)](https://godoc.org/golang.org/x/build/buildlet)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/buildlet.svg)](https://pkg.go.dev/golang.org/x/build/buildlet)
 
 # golang.org/x/build/buildlet
 
diff --git a/cmd/buildlet/stage0/README.md b/cmd/buildlet/stage0/README.md
index e8b781d..8ee261c 100644
--- a/cmd/buildlet/stage0/README.md
+++ b/cmd/buildlet/stage0/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/buildlet/stage0?status.svg)](https://godoc.org/golang.org/x/build/cmd/buildlet/stage0)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/buildlet/stage0.svg)](https://pkg.go.dev/golang.org/x/build/cmd/buildlet/stage0)
 
 # golang.org/x/build/cmd/buildlet/stage0
 
diff --git a/cmd/buildlet/testssh/README.md b/cmd/buildlet/testssh/README.md
new file mode 100644
index 0000000..d55fd20
--- /dev/null
+++ b/cmd/buildlet/testssh/README.md
@@ -0,0 +1,7 @@
+<!-- Auto-generated by x/build/update-readmes.go -->
+
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/buildlet/testssh.svg)](https://pkg.go.dev/golang.org/x/build/cmd/buildlet/testssh)
+
+# golang.org/x/build/cmd/buildlet/testssh
+
+The testssh binary exists to verify that a buildlet container's ssh works, without running the whole coordinator binary in the staging environment.
diff --git a/cmd/buildstats/README.md b/cmd/buildstats/README.md
index 8891b52..5703702 100644
--- a/cmd/buildstats/README.md
+++ b/cmd/buildstats/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/buildstats?status.svg)](https://godoc.org/golang.org/x/build/cmd/buildstats)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/buildstats.svg)](https://pkg.go.dev/golang.org/x/build/cmd/buildstats)
 
 # golang.org/x/build/cmd/buildstats
 
diff --git a/cmd/cl/README.md b/cmd/cl/README.md
index d491287..08e31aa 100644
--- a/cmd/cl/README.md
+++ b/cmd/cl/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/cl?status.svg)](https://godoc.org/golang.org/x/build/cmd/cl)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/cl.svg)](https://pkg.go.dev/golang.org/x/build/cmd/cl)
 
 # golang.org/x/build/cmd/cl
 
diff --git a/cmd/coordinator/internal/dashboard/README.md b/cmd/coordinator/internal/dashboard/README.md
new file mode 100644
index 0000000..f28cb83
--- /dev/null
+++ b/cmd/coordinator/internal/dashboard/README.md
@@ -0,0 +1,7 @@
+<!-- Auto-generated by x/build/update-readmes.go -->
+
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/coordinator/internal/dashboard.svg)](https://pkg.go.dev/golang.org/x/build/cmd/coordinator/internal/dashboard)
+
+# golang.org/x/build/cmd/coordinator/internal/dashboard
+
+Package dashboard contains the implementation of the build dashboard for the Coordinator.
diff --git a/cmd/coordinator/metrics/README.md b/cmd/coordinator/metrics/README.md
index c9978b3..de8b49d 100644
--- a/cmd/coordinator/metrics/README.md
+++ b/cmd/coordinator/metrics/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/coordinator/metrics?status.svg)](https://godoc.org/golang.org/x/build/cmd/coordinator/metrics)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/coordinator/metrics.svg)](https://pkg.go.dev/golang.org/x/build/cmd/coordinator/metrics)
 
 # golang.org/x/build/cmd/coordinator/metrics
 
diff --git a/cmd/debugnewvm/README.md b/cmd/debugnewvm/README.md
index d912328..ea5b859 100644
--- a/cmd/debugnewvm/README.md
+++ b/cmd/debugnewvm/README.md
@@ -1,7 +1,7 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/debugnewvm?status.svg)](https://godoc.org/golang.org/x/build/cmd/debugnewvm)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/debugnewvm.svg)](https://pkg.go.dev/golang.org/x/build/cmd/debugnewvm)
 
 # golang.org/x/build/cmd/debugnewvm
 
-The debugnewvm command creates and destroys a VM-based buildlets with lots of logging for debugging.
+The debugnewvm command creates and destroys a VM-based buildlet with lots of logging for debugging.
diff --git a/cmd/docker2boot/README.md b/cmd/docker2boot/README.md
index 1cf9ac4..cc7ea2b 100644
--- a/cmd/docker2boot/README.md
+++ b/cmd/docker2boot/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/docker2boot?status.svg)](https://godoc.org/golang.org/x/build/cmd/docker2boot)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/docker2boot.svg)](https://pkg.go.dev/golang.org/x/build/cmd/docker2boot)
 
 # golang.org/x/build/cmd/docker2boot
 
diff --git a/cmd/fetchlogs/README.md b/cmd/fetchlogs/README.md
index cf9615d..38e7dae 100644
--- a/cmd/fetchlogs/README.md
+++ b/cmd/fetchlogs/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/fetchlogs?status.svg)](https://godoc.org/golang.org/x/build/cmd/fetchlogs)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/fetchlogs.svg)](https://pkg.go.dev/golang.org/x/build/cmd/fetchlogs)
 
 # golang.org/x/build/cmd/fetchlogs
 
diff --git a/cmd/genbootstrap/README.md b/cmd/genbootstrap/README.md
index 8d2d1e3..40c8031 100644
--- a/cmd/genbootstrap/README.md
+++ b/cmd/genbootstrap/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/genbootstrap?status.svg)](https://godoc.org/golang.org/x/build/cmd/genbootstrap)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/genbootstrap.svg)](https://pkg.go.dev/golang.org/x/build/cmd/genbootstrap)
 
 # golang.org/x/build/cmd/genbootstrap
 
diff --git a/cmd/genbuilderkey/README.md b/cmd/genbuilderkey/README.md
new file mode 100644
index 0000000..6298446
--- /dev/null
+++ b/cmd/genbuilderkey/README.md
@@ -0,0 +1,7 @@
+<!-- Auto-generated by x/build/update-readmes.go -->
+
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/genbuilderkey.svg)](https://pkg.go.dev/golang.org/x/build/cmd/genbuilderkey)
+
+# golang.org/x/build/cmd/genbuilderkey
+
+The genbuilderkey binary generates a builder key or gomote user key from the build system's master key.
diff --git a/cmd/gerritbot/README.md b/cmd/gerritbot/README.md
index c6e0299..b3a8870 100644
--- a/cmd/gerritbot/README.md
+++ b/cmd/gerritbot/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/gerritbot?status.svg)](https://godoc.org/golang.org/x/build/cmd/gerritbot)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/gerritbot.svg)](https://pkg.go.dev/golang.org/x/build/cmd/gerritbot)
 
 # golang.org/x/build/cmd/gerritbot
 
diff --git a/cmd/gitmirror/README.md b/cmd/gitmirror/README.md
index e6584e2..7fd0728 100644
--- a/cmd/gitmirror/README.md
+++ b/cmd/gitmirror/README.md
@@ -1,7 +1,7 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/gitmirror?status.svg)](https://godoc.org/golang.org/x/build/cmd/gitmirror)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/gitmirror.svg)](https://pkg.go.dev/golang.org/x/build/cmd/gitmirror)
 
 # golang.org/x/build/cmd/gitmirror
 
-The gitmirror binary watches the specified Gerrit repositories for new commits and reports them to the build dashboard.
+The gitmirror binary watches the specified Gerrit repositories for new commits and syncs them to GitHub.
diff --git a/cmd/gomote/README.md b/cmd/gomote/README.md
index 55f6409..455fc07 100644
--- a/cmd/gomote/README.md
+++ b/cmd/gomote/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/gomote?status.svg)](https://godoc.org/golang.org/x/build/cmd/gomote)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/gomote.svg)](https://pkg.go.dev/golang.org/x/build/cmd/gomote)
 
 # golang.org/x/build/cmd/gomote
 
diff --git a/cmd/perfrun/README.md b/cmd/perfrun/README.md
index ca9cc8a..c4f84d4 100644
--- a/cmd/perfrun/README.md
+++ b/cmd/perfrun/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/perfrun?status.svg)](https://godoc.org/golang.org/x/build/cmd/perfrun)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/perfrun.svg)](https://pkg.go.dev/golang.org/x/build/cmd/perfrun)
 
 # golang.org/x/build/cmd/perfrun
 
diff --git a/cmd/pubsubhelper/pubsubtypes/README.md b/cmd/pubsubhelper/pubsubtypes/README.md
index 5858b95..7c2fc7f 100644
--- a/cmd/pubsubhelper/pubsubtypes/README.md
+++ b/cmd/pubsubhelper/pubsubtypes/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/pubsubhelper/pubsubtypes?status.svg)](https://godoc.org/golang.org/x/build/cmd/pubsubhelper/pubsubtypes)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/pubsubhelper/pubsubtypes.svg)](https://pkg.go.dev/golang.org/x/build/cmd/pubsubhelper/pubsubtypes)
 
 # golang.org/x/build/cmd/pubsubhelper/pubsubtypes
 
diff --git a/cmd/racebuild/README.md b/cmd/racebuild/README.md
index 38a0efb..e865d1e 100644
--- a/cmd/racebuild/README.md
+++ b/cmd/racebuild/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/racebuild?status.svg)](https://godoc.org/golang.org/x/build/cmd/racebuild)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/racebuild.svg)](https://pkg.go.dev/golang.org/x/build/cmd/racebuild)
 
 # golang.org/x/build/cmd/racebuild
 
diff --git a/cmd/release/README.md b/cmd/release/README.md
index 9150c7a..a261791 100644
--- a/cmd/release/README.md
+++ b/cmd/release/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/release?status.svg)](https://godoc.org/golang.org/x/build/cmd/release)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/release.svg)](https://pkg.go.dev/golang.org/x/build/cmd/release)
 
 # golang.org/x/build/cmd/release
 
diff --git a/cmd/relnote/README.md b/cmd/relnote/README.md
index c8fa789..fa7bbc8 100644
--- a/cmd/relnote/README.md
+++ b/cmd/relnote/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/relnote?status.svg)](https://godoc.org/golang.org/x/build/cmd/relnote)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/relnote.svg)](https://pkg.go.dev/golang.org/x/build/cmd/relnote)
 
 # golang.org/x/build/cmd/relnote
 
diff --git a/cmd/retrybuilds/README.md b/cmd/retrybuilds/README.md
index e1d3d210..a15993c 100644
--- a/cmd/retrybuilds/README.md
+++ b/cmd/retrybuilds/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/retrybuilds?status.svg)](https://godoc.org/golang.org/x/build/cmd/retrybuilds)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/retrybuilds.svg)](https://pkg.go.dev/golang.org/x/build/cmd/retrybuilds)
 
 # golang.org/x/build/cmd/retrybuilds
 
diff --git a/cmd/rmplaysnippet/README.md b/cmd/rmplaysnippet/README.md
new file mode 100644
index 0000000..43dea13
--- /dev/null
+++ b/cmd/rmplaysnippet/README.md
@@ -0,0 +1,7 @@
+<!-- Auto-generated by x/build/update-readmes.go -->
+
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/rmplaysnippet.svg)](https://pkg.go.dev/golang.org/x/build/cmd/rmplaysnippet)
+
+# golang.org/x/build/cmd/rmplaysnippet
+
+The rmplaysnippet binary removes a code snippet from play.golang.org given its URL or ID.
diff --git a/cmd/rundockerbuildlet/README.md b/cmd/rundockerbuildlet/README.md
index 3b0fc7f..f440f7a 100644
--- a/cmd/rundockerbuildlet/README.md
+++ b/cmd/rundockerbuildlet/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/rundockerbuildlet?status.svg)](https://godoc.org/golang.org/x/build/cmd/rundockerbuildlet)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/rundockerbuildlet.svg)](https://pkg.go.dev/golang.org/x/build/cmd/rundockerbuildlet)
 
 # golang.org/x/build/cmd/rundockerbuildlet
 
diff --git a/cmd/scaleway/README.md b/cmd/scaleway/README.md
index c4b7373..21054c5 100644
--- a/cmd/scaleway/README.md
+++ b/cmd/scaleway/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/scaleway?status.svg)](https://godoc.org/golang.org/x/build/cmd/scaleway)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/scaleway.svg)](https://pkg.go.dev/golang.org/x/build/cmd/scaleway)
 
 # golang.org/x/build/cmd/scaleway
 
diff --git a/cmd/updatecontrib/README.md b/cmd/updatecontrib/README.md
index 8af5980..4e5dbf8 100644
--- a/cmd/updatecontrib/README.md
+++ b/cmd/updatecontrib/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/updatecontrib?status.svg)](https://godoc.org/golang.org/x/build/cmd/updatecontrib)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/updatecontrib.svg)](https://pkg.go.dev/golang.org/x/build/cmd/updatecontrib)
 
 # golang.org/x/build/cmd/updatecontrib
 
diff --git a/cmd/updatedisks/README.md b/cmd/updatedisks/README.md
new file mode 100644
index 0000000..709b648
--- /dev/null
+++ b/cmd/updatedisks/README.md
@@ -0,0 +1,7 @@
+<!-- Auto-generated by x/build/update-readmes.go -->
+
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/updatedisks.svg)](https://pkg.go.dev/golang.org/x/build/cmd/updatedisks)
+
+# golang.org/x/build/cmd/updatedisks
+
+The updatedisks command creates & deletes VM disks as needed across the various GCP zones.
diff --git a/cmd/upload/README.md b/cmd/upload/README.md
index d7e4e8d..9cc5a64 100644
--- a/cmd/upload/README.md
+++ b/cmd/upload/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/upload?status.svg)](https://godoc.org/golang.org/x/build/cmd/upload)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/upload.svg)](https://pkg.go.dev/golang.org/x/build/cmd/upload)
 
 # golang.org/x/build/cmd/upload
 
diff --git a/cmd/xb/README.md b/cmd/xb/README.md
index 2ccc694..2c5f6e7 100644
--- a/cmd/xb/README.md
+++ b/cmd/xb/README.md
@@ -1,7 +1,7 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/cmd/xb?status.svg)](https://godoc.org/golang.org/x/build/cmd/xb)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/cmd/xb.svg)](https://pkg.go.dev/golang.org/x/build/cmd/xb)
 
 # golang.org/x/build/cmd/xb
 
-
+The xb command wraps GCP deployment commands such as gcloud, kubectl, and docker push and verifies they're interacting with the intended prod-vs-staging environment.
diff --git a/dashboard/README.md b/dashboard/README.md
index 90fa091..ac22c6f 100644
--- a/dashboard/README.md
+++ b/dashboard/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/dashboard?status.svg)](https://godoc.org/golang.org/x/build/dashboard)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/dashboard.svg)](https://pkg.go.dev/golang.org/x/build/dashboard)
 
 # golang.org/x/build/dashboard
 
diff --git a/envutil/README.md b/envutil/README.md
index 8c36481..6f43957 100644
--- a/envutil/README.md
+++ b/envutil/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/envutil?status.svg)](https://godoc.org/golang.org/x/build/envutil)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/envutil.svg)](https://pkg.go.dev/golang.org/x/build/envutil)
 
 # golang.org/x/build/envutil
 
diff --git a/gerrit/README.md b/gerrit/README.md
index f6376cc..b48c9b4 100644
--- a/gerrit/README.md
+++ b/gerrit/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/gerrit?status.svg)](https://godoc.org/golang.org/x/build/gerrit)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/gerrit.svg)](https://pkg.go.dev/golang.org/x/build/gerrit)
 
 # golang.org/x/build/gerrit
 
diff --git a/internal/buildgo/README.md b/internal/buildgo/README.md
index b76a367..de02cc3 100644
--- a/internal/buildgo/README.md
+++ b/internal/buildgo/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/internal/buildgo?status.svg)](https://godoc.org/golang.org/x/build/internal/buildgo)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/internal/buildgo.svg)](https://pkg.go.dev/golang.org/x/build/internal/buildgo)
 
 # golang.org/x/build/internal/buildgo
 
diff --git a/internal/buildstats/README.md b/internal/buildstats/README.md
index 3a2874a..359dcb0 100644
--- a/internal/buildstats/README.md
+++ b/internal/buildstats/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/internal/buildstats?status.svg)](https://godoc.org/golang.org/x/build/internal/buildstats)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/internal/buildstats.svg)](https://pkg.go.dev/golang.org/x/build/internal/buildstats)
 
 # golang.org/x/build/internal/buildstats
 
diff --git a/internal/foreach/README.md b/internal/foreach/README.md
new file mode 100644
index 0000000..6fa1c5b
--- /dev/null
+++ b/internal/foreach/README.md
@@ -0,0 +1,7 @@
+<!-- Auto-generated by x/build/update-readmes.go -->
+
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/internal/foreach.svg)](https://pkg.go.dev/golang.org/x/build/internal/foreach)
+
+# golang.org/x/build/internal/foreach
+
+Package foreach provides allocation-conscious helpers for iterating over lines of text.
diff --git a/internal/gitauth/README.md b/internal/gitauth/README.md
new file mode 100644
index 0000000..9c91ae2
--- /dev/null
+++ b/internal/gitauth/README.md
@@ -0,0 +1,7 @@
+<!-- Auto-generated by x/build/update-readmes.go -->
+
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/internal/gitauth.svg)](https://pkg.go.dev/golang.org/x/build/internal/gitauth)
+
+# golang.org/x/build/internal/gitauth
+
+Package gitauth writes gitcookies files so git will authenticate to Gerrit as gopherbot for quota purposes.
diff --git a/internal/gophers/README.md b/internal/gophers/README.md
index cb12644..b4bcf69 100644
--- a/internal/gophers/README.md
+++ b/internal/gophers/README.md
@@ -1,7 +1,7 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/internal/gophers?status.svg)](https://godoc.org/golang.org/x/build/internal/gophers)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/internal/gophers.svg)](https://pkg.go.dev/golang.org/x/build/internal/gophers)
 
 # golang.org/x/build/internal/gophers
 
-Package gophers is a list of names, emails, and Github usernames of people from the Go git repos and issue trackers.
+Package gophers is a list of names, emails, and GitHub usernames of people from the Go git repos and issue trackers.
diff --git a/internal/httpdl/README.md b/internal/httpdl/README.md
index 7551ea8..70f0f05 100644
--- a/internal/httpdl/README.md
+++ b/internal/httpdl/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/internal/httpdl?status.svg)](https://godoc.org/golang.org/x/build/internal/httpdl)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/internal/httpdl.svg)](https://pkg.go.dev/golang.org/x/build/internal/httpdl)
 
 # golang.org/x/build/internal/httpdl
 
diff --git a/internal/https/README.md b/internal/https/README.md
index 928cf7d..9b22efe 100644
--- a/internal/https/README.md
+++ b/internal/https/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/internal/https?status.svg)](https://godoc.org/golang.org/x/build/internal/https)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/internal/https.svg)](https://pkg.go.dev/golang.org/x/build/internal/https)
 
 # golang.org/x/build/internal/https
 
diff --git a/internal/loghash/README.md b/internal/loghash/README.md
index 21c3564..d355751 100644
--- a/internal/loghash/README.md
+++ b/internal/loghash/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/internal/loghash?status.svg)](https://godoc.org/golang.org/x/build/internal/loghash)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/internal/loghash.svg)](https://pkg.go.dev/golang.org/x/build/internal/loghash)
 
 # golang.org/x/build/internal/loghash
 
diff --git a/internal/lru/README.md b/internal/lru/README.md
index ddbf364..1e015c8 100644
--- a/internal/lru/README.md
+++ b/internal/lru/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/internal/lru?status.svg)](https://godoc.org/golang.org/x/build/internal/lru)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/internal/lru.svg)](https://pkg.go.dev/golang.org/x/build/internal/lru)
 
 # golang.org/x/build/internal/lru
 
diff --git a/internal/secret/README.md b/internal/secret/README.md
new file mode 100644
index 0000000..4673cb6
--- /dev/null
+++ b/internal/secret/README.md
@@ -0,0 +1,7 @@
+<!-- Auto-generated by x/build/update-readmes.go -->
+
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/internal/secret.svg)](https://pkg.go.dev/golang.org/x/build/internal/secret)
+
+# golang.org/x/build/internal/secret
+
+Package secret provides a client interface for interacting with the GCP Secret Management service.
diff --git a/internal/singleflight/README.md b/internal/singleflight/README.md
index a0ced11..2cc9516 100644
--- a/internal/singleflight/README.md
+++ b/internal/singleflight/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/internal/singleflight?status.svg)](https://godoc.org/golang.org/x/build/internal/singleflight)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/internal/singleflight.svg)](https://pkg.go.dev/golang.org/x/build/internal/singleflight)
 
 # golang.org/x/build/internal/singleflight
 
diff --git a/internal/sourcecache/README.md b/internal/sourcecache/README.md
index 84960eb..1cc230f 100644
--- a/internal/sourcecache/README.md
+++ b/internal/sourcecache/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/internal/sourcecache?status.svg)](https://godoc.org/golang.org/x/build/internal/sourcecache)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/internal/sourcecache.svg)](https://pkg.go.dev/golang.org/x/build/internal/sourcecache)
 
 # golang.org/x/build/internal/sourcecache
 
diff --git a/internal/spanlog/README.md b/internal/spanlog/README.md
new file mode 100644
index 0000000..f1725da
--- /dev/null
+++ b/internal/spanlog/README.md
@@ -0,0 +1,7 @@
+<!-- Auto-generated by x/build/update-readmes.go -->
+
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/internal/spanlog.svg)](https://pkg.go.dev/golang.org/x/build/internal/spanlog)
+
+# golang.org/x/build/internal/spanlog
+
+Package spanlog provides span and event logger interfaces.
diff --git a/internal/untar/README.md b/internal/untar/README.md
index 3eafec4..7171281 100644
--- a/internal/untar/README.md
+++ b/internal/untar/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/internal/untar?status.svg)](https://godoc.org/golang.org/x/build/internal/untar)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/internal/untar.svg)](https://pkg.go.dev/golang.org/x/build/internal/untar)
 
 # golang.org/x/build/internal/untar
 
diff --git a/kubernetes/README.md b/kubernetes/README.md
index 2921853..50c75e0 100644
--- a/kubernetes/README.md
+++ b/kubernetes/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/kubernetes?status.svg)](https://godoc.org/golang.org/x/build/kubernetes)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/kubernetes.svg)](https://pkg.go.dev/golang.org/x/build/kubernetes)
 
 # golang.org/x/build/kubernetes
 
diff --git a/kubernetes/api/README.md b/kubernetes/api/README.md
index 315526a..c9ec66c 100644
--- a/kubernetes/api/README.md
+++ b/kubernetes/api/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/kubernetes/api?status.svg)](https://godoc.org/golang.org/x/build/kubernetes/api)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/kubernetes/api.svg)](https://pkg.go.dev/golang.org/x/build/kubernetes/api)
 
 # golang.org/x/build/kubernetes/api
 
diff --git a/kubernetes/gke/README.md b/kubernetes/gke/README.md
index ae21cd5..49d8b5f 100644
--- a/kubernetes/gke/README.md
+++ b/kubernetes/gke/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/kubernetes/gke?status.svg)](https://godoc.org/golang.org/x/build/kubernetes/gke)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/kubernetes/gke.svg)](https://pkg.go.dev/golang.org/x/build/kubernetes/gke)
 
 # golang.org/x/build/kubernetes/gke
 
diff --git a/livelog/README.md b/livelog/README.md
index 195cff7..50fe602 100644
--- a/livelog/README.md
+++ b/livelog/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/livelog?status.svg)](https://godoc.org/golang.org/x/build/livelog)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/livelog.svg)](https://pkg.go.dev/golang.org/x/build/livelog)
 
 # golang.org/x/build/livelog
 
diff --git a/maintner/README.md b/maintner/README.md
index 7e8e92f..0421202 100644
--- a/maintner/README.md
+++ b/maintner/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/maintner?status.svg)](https://godoc.org/golang.org/x/build/maintner)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/maintner.svg)](https://pkg.go.dev/golang.org/x/build/maintner)
 
 # golang.org/x/build/maintner
 
diff --git a/maintner/godata/README.md b/maintner/godata/README.md
index b136a60..10c8614 100644
--- a/maintner/godata/README.md
+++ b/maintner/godata/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/maintner/godata?status.svg)](https://godoc.org/golang.org/x/build/maintner/godata)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/maintner/godata.svg)](https://pkg.go.dev/golang.org/x/build/maintner/godata)
 
 # golang.org/x/build/maintner/godata
 
diff --git a/maintner/gostats/README.md b/maintner/gostats/README.md
index d5731bc..577b09e 100644
--- a/maintner/gostats/README.md
+++ b/maintner/gostats/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/maintner/gostats?status.svg)](https://godoc.org/golang.org/x/build/maintner/gostats)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/maintner/gostats.svg)](https://pkg.go.dev/golang.org/x/build/maintner/gostats)
 
 # golang.org/x/build/maintner/gostats
 
diff --git a/maintner/maintnerd/README.md b/maintner/maintnerd/README.md
index 6428651..24a1fdd 100644
--- a/maintner/maintnerd/README.md
+++ b/maintner/maintnerd/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/maintner/maintnerd?status.svg)](https://godoc.org/golang.org/x/build/maintner/maintnerd)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/maintner/maintnerd.svg)](https://pkg.go.dev/golang.org/x/build/maintner/maintnerd)
 
 # golang.org/x/build/maintner/maintnerd
 
diff --git a/maintner/maintnerd/gcslog/README.md b/maintner/maintnerd/gcslog/README.md
new file mode 100644
index 0000000..3500b9c
--- /dev/null
+++ b/maintner/maintnerd/gcslog/README.md
@@ -0,0 +1,7 @@
+<!-- Auto-generated by x/build/update-readmes.go -->
+
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/maintner/maintnerd/gcslog.svg)](https://pkg.go.dev/golang.org/x/build/maintner/maintnerd/gcslog)
+
+# golang.org/x/build/maintner/maintnerd/gcslog
+
+Package gcslog is an implementation of maintner.MutationSource and Logger for Google Cloud Storage.
diff --git a/maintner/maintnerd/maintapi/README.md b/maintner/maintnerd/maintapi/README.md
new file mode 100644
index 0000000..1f3386f
--- /dev/null
+++ b/maintner/maintnerd/maintapi/README.md
@@ -0,0 +1,7 @@
+<!-- Auto-generated by x/build/update-readmes.go -->
+
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/maintner/maintnerd/maintapi.svg)](https://pkg.go.dev/golang.org/x/build/maintner/maintnerd/maintapi)
+
+# golang.org/x/build/maintner/maintnerd/maintapi
+
+Package maintapi exposes a gRPC maintner service for a given corpus.
diff --git a/maintner/maintnerd/maintapi/version/README.md b/maintner/maintnerd/maintapi/version/README.md
new file mode 100644
index 0000000..867155f
--- /dev/null
+++ b/maintner/maintnerd/maintapi/version/README.md
@@ -0,0 +1,7 @@
+<!-- Auto-generated by x/build/update-readmes.go -->
+
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/maintner/maintnerd/maintapi/version.svg)](https://pkg.go.dev/golang.org/x/build/maintner/maintnerd/maintapi/version)
+
+# golang.org/x/build/maintner/maintnerd/maintapi/version
+
+Package version implements logic to parse version of Go tags and release branches.
diff --git a/maintner/maintpb/README.md b/maintner/maintpb/README.md
index 0fb8aff..9641837 100644
--- a/maintner/maintpb/README.md
+++ b/maintner/maintpb/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/maintner/maintpb?status.svg)](https://godoc.org/golang.org/x/build/maintner/maintpb)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/maintner/maintpb.svg)](https://pkg.go.dev/golang.org/x/build/maintner/maintpb)
 
 # golang.org/x/build/maintner/maintpb
 
diff --git a/maintner/maintq/README.md b/maintner/maintq/README.md
index 58c7883..1dd2fcd 100644
--- a/maintner/maintq/README.md
+++ b/maintner/maintq/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/maintner/maintq?status.svg)](https://godoc.org/golang.org/x/build/maintner/maintq)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/maintner/maintq.svg)](https://pkg.go.dev/golang.org/x/build/maintner/maintq)
 
 # golang.org/x/build/maintner/maintq
 
diff --git a/maintner/maintwatch/README.md b/maintner/maintwatch/README.md
new file mode 100644
index 0000000..7d44f96
--- /dev/null
+++ b/maintner/maintwatch/README.md
@@ -0,0 +1,7 @@
+<!-- Auto-generated by x/build/update-readmes.go -->
+
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/maintner/maintwatch.svg)](https://pkg.go.dev/golang.org/x/build/maintner/maintwatch)
+
+# golang.org/x/build/maintner/maintwatch
+
+The maintwatch commands tails the maintner mutation log.
diff --git a/maintner/reclog/README.md b/maintner/reclog/README.md
index f3cd677..56c310a 100644
--- a/maintner/reclog/README.md
+++ b/maintner/reclog/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/maintner/reclog?status.svg)](https://godoc.org/golang.org/x/build/maintner/reclog)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/maintner/reclog.svg)](https://pkg.go.dev/golang.org/x/build/maintner/reclog)
 
 # golang.org/x/build/maintner/reclog
 
diff --git a/pargzip/README.md b/pargzip/README.md
index 5872dbb..131d9af 100644
--- a/pargzip/README.md
+++ b/pargzip/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/pargzip?status.svg)](https://godoc.org/golang.org/x/build/pargzip)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/pargzip.svg)](https://pkg.go.dev/golang.org/x/build/pargzip)
 
 # golang.org/x/build/pargzip
 
diff --git a/repos/README.md b/repos/README.md
new file mode 100644
index 0000000..efb8783
--- /dev/null
+++ b/repos/README.md
@@ -0,0 +1,7 @@
+<!-- Auto-generated by x/build/update-readmes.go -->
+
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/repos.svg)](https://pkg.go.dev/golang.org/x/build/repos)
+
+# golang.org/x/build/repos
+
+Package repos contains information about Go source repositories.
diff --git a/revdial/v2/README.md b/revdial/v2/README.md
new file mode 100644
index 0000000..cd2bdcd
--- /dev/null
+++ b/revdial/v2/README.md
@@ -0,0 +1,7 @@
+<!-- Auto-generated by x/build/update-readmes.go -->
+
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/revdial/v2.svg)](https://pkg.go.dev/golang.org/x/build/revdial/v2)
+
+# golang.org/x/build/revdial/v2
+
+Package revdial implements a Dialer and Listener which work together to turn an accepted connection (for instance, a Hijacked HTTP request) into a Dialer which can then create net.Conns connecting back to the original dialer, which then gets a net.Listener accepting those conns.
diff --git a/tarutil/README.md b/tarutil/README.md
index a2ef8a2..b42330a 100644
--- a/tarutil/README.md
+++ b/tarutil/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/tarutil?status.svg)](https://godoc.org/golang.org/x/build/tarutil)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/tarutil.svg)](https://pkg.go.dev/golang.org/x/build/tarutil)
 
 # golang.org/x/build/tarutil
 
diff --git a/types/README.md b/types/README.md
index fd50331..d859aa1 100644
--- a/types/README.md
+++ b/types/README.md
@@ -1,6 +1,6 @@
 <!-- Auto-generated by x/build/update-readmes.go -->
 
-[![GoDoc](https://godoc.org/golang.org/x/build/types?status.svg)](https://godoc.org/golang.org/x/build/types)
+[![Go Reference](https://pkg.go.dev/badge/golang.org/x/build/types.svg)](https://pkg.go.dev/golang.org/x/build/types)
 
 # golang.org/x/build/types
 
diff --git a/update-readmes.go b/update-readmes.go
index 621015e..2e8bfe7 100644
--- a/update-readmes.go
+++ b/update-readmes.go
@@ -47,6 +47,10 @@
 			// Skip.
 			return nil
 		}
+		if pkg.Doc == "" {
+			// There's no package comment, so don't create an empty README.
+			return nil
+		}
 		if _, err := os.Stat(filepath.Join(pkg.Dir, "README")); err == nil {
 			// Directory has exiting README; don't touch.
 			return nil
@@ -63,7 +67,7 @@
 		}
 		newContents := []byte(fmt.Sprintf(`<!-- %s -->
 
-[![GoDoc](https://godoc.org/%s?status.svg)](https://godoc.org/%s)
+[![Go Reference](https://pkg.go.dev/badge/%s.svg)](https://pkg.go.dev/%s)
 
 # %s