[gopls-release-branch.0.20] gopls/doc/release/v0.20.0.md: final tweaks
Updates golang/go#74655
Change-Id: I5e3b78ca86d7c608d90098c605313146185e8cca
Reviewed-on: https://go-review.googlesource.com/c/tools/+/690955
Reviewed-by: Robert Findley <rfindley@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
(cherry picked from commit 7fe7caec10b6021edd5985f6601fb123e47b9a7e)
Reviewed-on: https://go-review.googlesource.com/c/tools/+/690995
Auto-Submit: Alan Donovan <adonovan@google.com>
Reviewed-by: Hongxiang Jiang <hxjiang@golang.org>
diff --git a/gopls/doc/index.md b/gopls/doc/index.md
index e7908ff..ddbb7c2 100644
--- a/gopls/doc/index.md
+++ b/gopls/doc/index.md
@@ -26,6 +26,9 @@
Also, the gopls documentation for each feature describes whether it is
supported in each client editor.
+This documentation (https://go.dev/gopls) describes the most recent release of gopls.
+To preview documentation for the release under development, visit https://tip.golang.org/gopls.
+
## Features
Gopls supports a wide range of standard LSP features for navigation,
diff --git a/gopls/doc/release/v0.20.0.md b/gopls/doc/release/v0.20.0.md
index 84c1b60..2854f4c 100644
--- a/gopls/doc/release/v0.20.0.md
+++ b/gopls/doc/release/v0.20.0.md
@@ -1,20 +1,22 @@
---
-title: "Gopls release v0.20.0 (forthcoming)"
+title: "Gopls release v0.20.0"
---
-This release contains a new experimental Model Context Protocol server for
-gopls, which may be used to integrate a subset of gopls' features in
-AI-assisted environments.
+This release contains a new experimental Model Context Protocol (MCP)
+server for gopls, which may be used to integrate a subset of gopls'
+features in AI-assisted environments.
-Additionally, gopls' documentation is now available on the Go project's website
-at https://go.dev/gopls. (Note: this link will not be accurate until the
-completion of the release. Dueing the pre-release period, please use
-https://tip.golang.org/gopls, which reflects the latest commit.)
-
-Unlike markdown files in GitHub, these pages are crawled by Google's
+Gopls' documentation is now available on the Go project's website at
+https://go.dev/gopls. (This link reflects the latest gopls release;
+use https://tip.golang.org/gopls to see docs for the latest commit.)
+Unlike Markdown files in GitHub, these pages are crawled by Google's
web search index.
-## Configuration Changes
+## Configuration changes
+
+This release enables by default the new persistent index of packages
+in the module cache. This was first attempted in [v0.19.0] but reverted
+due to problems that have since been fixed.
## Web-based features
@@ -38,14 +40,6 @@
you must do that step by hand.
-<!--
-
-### $feature
-
-https://go.dev/issue#xxxxx
-
--->
-
## Editing features
### Model Context Protocol server
@@ -58,9 +52,9 @@
**Caveats:** This is a brand new mode of operation for gopls, and so we're
still experimenting with the best set of tools and instructions to provide.
-Please let us know how well it works for you. Also, please be aware that using
-gopls in an AI powered environment may carry additional security
-considerations, as discussed in the documentation above.
+Please let us know how well it works for you. Also, please be aware that
+allowing LLMs to execute operations in your workspace entails additional
+security considerations, as discussed in the documentation above.
## Analysis features
@@ -98,3 +92,8 @@
the analysis framework since it depends on the entire workspace.)
## Code transformation features
+
+<!-- golang/go#45199 -->
+The Rename operation now allows you to rename an embedded field, such
+as T in `struct{ T }`, so long as the operation is requested at the
+field declaration (T). Both the field and its type will be renamed.
diff --git a/gopls/doc/release/v0.21.0.md b/gopls/doc/release/v0.21.0.md
new file mode 100644
index 0000000..40fe02a
--- /dev/null
+++ b/gopls/doc/release/v0.21.0.md
@@ -0,0 +1,21 @@
+---
+title: "Gopls release v0.21.0 (forthcoming)"
+---
+
+## Configuration changes
+## Web-based features
+## Editing features
+## Analysis features
+## Code transformation features
+
+<!-- golang/go#42301 -->
+The Rename operation now treats [Doc Links](https://tip.golang.org/doc/comment#doclinks)
+like identifiers, so you can initiate a renaming from a Doc Link.
+
+<!--
+
+### $feature
+
+https://go.dev/issue#xxxxx
+
+-->
