gopls/doc: more doc tweaks

For golang/go#68977

Change-Id: I1439b62c47bfc193a54c02584fe11594163f3f70
Reviewed-on: https://go-review.googlesource.com/c/tools/+/686836
LUCI-TryBot-Result: Go LUCI <[email protected]>
Auto-Submit: Alan Donovan <[email protected]>
Reviewed-by: Robert Findley <[email protected]>

Author: adonovan

gopls/doc/features/index.md

@@ -68,4 +68,4 @@ when making significant changes to existing features or when adding new ones.
 You can find this page from within your editor by executing the
 `gopls.doc.features` [code action](transformation.md#code-actions),
 which opens it in a web browser.
-In VS Code, you can find it on the Quick fix menu.
+In VS Code, you can find it on the "Quick fix" menu.

gopls/doc/features/navigation.md

@@ -73,7 +73,7 @@ for the references to a symbol defined in `foo_windows.go`, the result
 will never include the file `bar_linux.go`, even if that file refers
 to a symbol of the same name; see https://go.dev/issue/65755.
 
-Clients can request that the the declaration be included among the
+Clients can request that the declaration be included among the
 references; most do.
 
 Client support:

gopls/doc/features/web.md

@@ -170,12 +170,12 @@ could (in principle) be split into three subpackages, one for
 formatting (`Printf` and friends), one for scanning (`Scanf`), and one
 for their common dependencies.
 
-<img title="Split package 'fmt'" src="../assets/splitpkg.png">
+<img title="Split package 'fmt'" src="../assets/splitpkg.png" width="55%">
 
 (Try playing with the tool on this package: it's an instructive
 exercise. The figure below shows the solution.)
 
-<img title="Split package 'fmt'" src="../assets/splitpkg-deps.png">
+<img title="Split package 'fmt'" src="../assets/splitpkg-deps.png" width="55%">
 
 The tool does not currently perform the code transformation (moving
 declarations to new packages, renaming symbols to export them as

gopls/doc/index.md

@@ -1,7 +1,13 @@
 ---
 title: "Gopls: The language server for Go"
 ---
-<!-- This is the main landing page for gopls users. -->
+<!--
+  This is the main landing page for gopls users.
+
+  To preview locally edited markdown files, use:
+    $ GOLANGORG_LOCAL_X_TOOLS=$(pwd) go run golang.org/x/website/cmd/golangorg@master &
+    $ open http://localhost:6060/go.dev/gopls
+-->
 
 [![PkgGoDev](https://pkg.go.dev/badge/golang.org/x/tools/gopls)](https://pkg.go.dev/golang.org/x/tools/gopls)
 

gopls/doc/release/v0.16.0.md

@@ -102,7 +102,7 @@ Editor support:
 - Emacs: requires eglot v1.17. Use `M-x go-browse-doc` from github.com/dominikh/go-mode.el.
 
 The `linksInHover` setting now supports a new value, `"gopls"`,
-that causes documentation links in the the Markdown output
+that causes documentation links in the Markdown output
 of the Hover operation to link to gopls' internal doc viewer.
 
 ### Browse free symbols

gopls/doc/release/v0.20.0.md

@@ -2,6 +2,14 @@
 title: "Gopls release v0.20.0 (forthcoming)"
 ---
 
+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
+web search index.
+
 ## Configuration Changes
 
 ## Navigation features