suggestions from code review

docs/reference/extensions/go-framework.rst

@@ -6,9 +6,8 @@ go-framework
 The Go extension streamlines the process of building Go application
 rocks.
 
-The extension builds and copies the Go binary file to the rock,
-inside the ``/app`` directory. By default, the base ``bare`` is used,
-to generate a lightweight image.
+The extension builds and copies the Go binary file to the rock.
+By default, the base ``bare`` is used, to generate a lightweight image.
 
 
 .. note::
@@ -27,7 +26,7 @@ in the root directory of the project.
 
 If the main package is in the base directory and the rockcraft name
 attribute is equal to the go module name, the name of the binary will
-be selected correctly, otherwise you can adjust it.
+be selected correctly, otherwise you will need to adjust it.
 
 You can use this field to specify a different binary to be used as the
 main application, without having to override the service command. For example,
@@ -48,8 +47,9 @@ next snippet:
 =========================================================
 
 
-Some files, if they exist, are included by default. These include:
-``migrate``, ``migrate.sh``, ``templates/`` and ``static/``.
+Some files, if they exist, are included by default in the rock in the
+``/app`` directory.  These include: ``migrate``, ``migrate.sh``,
+``templates/`` and ``static/``.
 
 You can customise the files to include by overriding the ``stage`` property
 of the ``go-framework/assets`` part:

docs/tutorial/go.rst

@@ -61,9 +61,10 @@ Build the Go application so it can be run:
     :end-before: [docs:go-build-end]
     :dedent: 2
 
-A new binary named ``go-hello-world`` should be in the current directory.
-Run the Go application using ``./go-hello-world`` to verify that
-it works.
+A new binary named ``go-hello-world`` should be in the current
+directory.  This binary is only needed for local testing, as
+Rockcraft will compile the Go application. Run the Go application using
+``./go-hello-world`` to verify that it works.
 
 Test the Go application by using ``curl`` to send a request to the root
 endpoint. We may need a new terminal for this, if we are using Multipass use