cmd/coordinator: update documentation

Update documentation to reflect changes from the dashboard unification.

For golang/go#34744.

Change-Id: Ifb61207dd61496df0e8e9c96fd05730399e3a4b8
Reviewed-on: https://go-review.googlesource.com/c/build/+/340434
Trust: Dmitri Shuralyov <[email protected]>
Reviewed-by: Carlos Amedee <[email protected]>

Author: dmitshur

README.md

@@ -18,19 +18,13 @@ https://github.com/golang/go/issues. Prefix your issue with
 
 The main components of the Go build system are:
 
-* The **dashboard**, in [app/](https://dev.golang.org/dir/build/app), serves
-  https://build.golang.org/. It runs on App Engine and holds the state for
-  which builds passed or failed, and stores the build failure logs for
-  post-submit failures. (Trybot build failure logs are stored elsewhere).
-  The dashboard does not execute any builds on its own.
-
-
 * The **coordinator**, in
   [cmd/coordinator/](https://dev.golang.org/dir/build/cmd/coordinator/),
-  serves https://farmer.golang.org/. It runs on GKE and coordinates the
-  whole build system. It finds work to do (both pre-submit "TryBot" work,
-  and post-submit work) and executes builds, allocating machines to run the
-  builds. It is the owner of all machines.
+  serves https://farmer.golang.org/ and https://build.golang.org/.
+  It runs on GKE and coordinates the whole build system. It finds work
+  to do (both pre-submit "TryBot" work, and post-submit work) and executes
+  builds, allocating machines to run the builds. It is the owner of all machines.
+  It holds the state for which builds passed or failed, and the build logs.
 
 * The Go package in [buildenv/](https://dev.golang.org/dir/build/buildenv/)
   contains constants for where the dashboard and coordinator run, for prod,
@@ -67,7 +61,7 @@ The main components of the Go build system are:
   over the already-open TCP connection.
 
   These three pools can be viewed at the coordinator's
-  http://farmer.golang.org/#pools
+  https://farmer.golang.org/#pools.
 
 
 * The [env/](https://dev.golang.org/dir/build/env/) directory describes

cmd/coordinator/README.md

@@ -6,19 +6,23 @@ Building, running tests, running locally is supported on Linux and macOS only.
 
 Run
 
-    go run golang.org/x/build/cmd/coordinator --mode=dev --env=dev
+```sh
+go run golang.org/x/build/cmd/coordinator -mode=dev -env=dev
+```
 
 to start a server on https://localhost:8119. Proceed past the TLS warning and
 you should get the homepage. Some features won't work when running locally,
-but you should be able to view the homepage and the builders page and do basic
-sanity checks.
+but you should be able to navigate between the homepage, the dashboard,
+the builders page, and do limited local development and testing.
 
 #### Render the "Trybot Status" page locally
 
 To view/modify the "Trybot Status" page locally, you can run the coordinator
 with the `-dev` tag.
 
-    go run -tags=dev golang.org/x/build/cmd/coordinator --mode=dev --env=dev
+```sh
+go run -tags=dev golang.org/x/build/cmd/coordinator -mode=dev -env=dev
+```
 
 Then visit https://localhost:8119/try-dev in your browser.
 You should see a trybot status page with some example data.

cmd/coordinator/coordinator.go

@@ -8,8 +8,8 @@
 
 // The coordinator runs the majority of the Go build system.
 //
-// It is responsible for finding build work and executing it,
-// reporting the results to build.golang.org for public display.
+// It is responsible for finding build work, executing it,
+// and displaying the results.
 //
 // For an overview of the Go build system, see the README at
 // the root of the x/build repo.