[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 7fe7cae)
Reviewed-on: https://go-review.googlesource.com/c/tools/+/690995
Auto-Submit: Alan Donovan <adonovan@google.com>
Reviewed-by: Hongxiang Jiang <hxjiang@golang.org>

Author: adonovan

gopls/doc/index.md

@@ -26,6 +26,9 @@ by editor, so we recommend that you proceed to the
 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,

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 @@ the tool will automate the code transformation, but for now
 you must do that step by hand.
 
 
-<!--
-
-### $feature
-
-https://go.dev/issue#xxxxx
-
--->
-
 ## Editing features
 
 ### Model Context Protocol server
@@ -58,9 +52,9 @@ See the [documentation](../features/mcp.md) for more information.
 
 **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 @@ that are unreferenced within their declaring package.
 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.

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
+
+-->