static/frontend: improve package removal documentation
For golang/go#55834.
Change-Id: I085414053ab4cdfb228aa622bd4e08eca2cc44b9
Reviewed-on: https://go-review.googlesource.com/c/pkgsite/+/443341
Run-TryBot: Jamal Carvalho <jamal@golang.org>
Reviewed-by: Hyang-Ah Hana Kim <hyangah@gmail.com>
diff --git a/static/frontend/about/about.tmpl b/static/frontend/about/about.tmpl
index 6925e91..71181d3 100644
--- a/static/frontend/about/about.tmpl
+++ b/static/frontend/about/about.tmpl
@@ -66,18 +66,23 @@
<h2 id="removing-a-package">Removing a package</h2>
<p>
- If you would like to hide versions of a module on pkg.go.dev, as well as from
- the <code>go</code> command, you should retract them.
- Retracting a module version involves adding a <code>retract</code> directive
- to your <code>go.mod</code> file and publishing a new version.
- See the Go blog post
- <a href="https://go.dev/blog/go116-module-changes#TOC_5.">New module changes in Go 1.16</a>
+ If you would like to hide versions of a module on pkg.go.dev, as well as from the <code>go</code> command,
+ you should retract them. Retracting a module version involves adding a <code>retract</code> directive to
+ your go.mod file and publishing a new version. See the Go blog post
+ <a href="https://go.dev/blog/go116-module-changes#module-retraction">New module changes in Go 1.16</a>
and the <a href="https://go.dev/ref/mod#go-mod-file-retract">modules reference</a> for details.
</p>
<p>
- If you cannot retract your module, you can
- <a href="https://go.dev/s/pkgsite-package-removal">file a request</a> for the pkgsite
- team to remove your package.
+ Note that it is possible to retract the latest version of a module; the modules reference link above
+ includes an example. Also note that published versions cannot be reused or modified, and this includes
+ retracted versions.
+ </p>
+ <p>
+ If you cannot publish a new version with retractions because the source code repository or domain
+ name is no longer accessible, or if you want to hide documentation for all current and future versions,
+ you can <a href="https://go.dev/s/pkgsite-package-removal">file a request</a> for the pkgsite team to hide
+ your package documentation from pkg.go.dev. Note that the package will continue to be available via
+ <code>go get</code> or <code>go install</code> unless its module is retracted.
</p>
<h2 id="documentation">Documentation</h2>
diff --git a/tests/screentest/testcases.txt b/tests/screentest/testcases.txt
index e1e1e69..1d2557d 100644
--- a/tests/screentest/testcases.txt
+++ b/tests/screentest/testcases.txt
@@ -143,6 +143,11 @@
capture fullscreen
capture fullscreen 540x1080
+test about
+pathname /about
+capture fullscreen
+capture fullscreen 540x1080
+
test badge
pathname /badge/
capture fullscreen
diff --git a/tests/screentest/testdata/about-540x1080.a.png b/tests/screentest/testdata/about-540x1080.a.png
new file mode 100644
index 0000000..275a791
--- /dev/null
+++ b/tests/screentest/testdata/about-540x1080.a.png
Binary files differ
diff --git a/tests/screentest/testdata/about.a.png b/tests/screentest/testdata/about.a.png
new file mode 100644
index 0000000..850047e
--- /dev/null
+++ b/tests/screentest/testdata/about.a.png
Binary files differ