gopls/doc: yet more tweaks

- move pkg.go.dev link into Contributing
- update links
- fix typos

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

Author: adonovan

gopls/doc/contributing.md

@@ -10,11 +10,9 @@ So, before sending a CL, please please please:
   exist already. This allows us to identify redundant requests, or to
   merge a specific problem into a more general one, and to assess the
   importance of the problem.
-
 - **claim it for yourself** by commenting on the issue or, if you are
   able, by assigning the issue to yourself. This helps us avoid two
   people working on the same problem.
-
 - **propose an implementation plan** in the issue tracker for CLs of
   any complexity. It is much more efficient to discuss the plan at a
   high level before we start getting bogged down in the details of
@@ -41,7 +39,7 @@ for example by making the code self-explanatory.
 It's fine to disagree with a comment,
 point out a reviewer's mistake,
 or offer to address a comment in a follow-up change,
-leaving a TODO comment in the current CL.
+leaving a `TODO` comment in the current CL.
 But please don't dismiss or quietly ignore a comment without action,
 as it may lead reviewers to repeat themselves,
 or to serious problems being neglected.
@@ -60,8 +58,10 @@ claiming it.
 
 ## Getting started
 
-Most of the `gopls` logic is in the `golang.org/x/tools/gopls/internal`
-directory. See [design/implementation.md](./design/implementation.md) for an overview of the code organization.
+[![PkgGoDev](https://pkg.go.dev/badge/golang.org/x/tools/gopls/internal)](https://pkg.go.dev/golang.org/x/tools/gopls/internal)
+
+Most of the `gopls` logic is in the `golang.org/x/tools/gopls/internal` directory.
+See [design/implementation.md](./design/implementation.md) for an overview of the code organization.
 
 ## Build
 

gopls/doc/index.md

@@ -9,8 +9,6 @@ title: "Gopls: The language server for Go"
     $ 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` (pronounced "Go please") is the official [language
 server](https://langserver.org) for Go, developed by the Go team. It
 provides a wide variety of [IDE features](features/) to any
@@ -32,7 +30,7 @@ To preview documentation for the release under development, visit https://tip.go
 ## Features
 
 Gopls supports a wide range of standard LSP features for navigation,
-completion, diagnostics, analysis, and refactoring, and number of
+completion, diagnostics, analysis, and refactoring, and a number of
 additional features not found in other language servers.
 
 See the [Index of features](features/) for complete

gopls/main.go

@@ -7,9 +7,8 @@
 // to be extended with IDE-like features;
 // see https://langserver.org/ for details.
 //
-// See https://github.com/golang/tools/blob/master/gopls/doc/index.md
-// for the most up-to-date documentation.
-package main // import "golang.org/x/tools/gopls"
+// See https://go.dev/gopls for comprehensive documentation on Gopls.
+package main
 
 import (
 	"context"