golang: Rework [gowork] documentation a bit

Put emphasis on that gowork defines Go workspace and explain first
settings that are related to that definition. Only after that say how to
use gowork.install. The reason for this is that gowork.install will
become optional in the next patch.

component/golang/buildout.cfg

@@ -80,30 +80,39 @@ environment-extra =
 
 # ---- infrastructure to build Go workspaces / projects ----
 
-# gowork is a top-level section representing workspace
+# gowork is the top-level section that defines Go workspace.
 #
-# users should add `install` field to [gowork] to describe packages they want to
-# be installed (+ automatically their dependencies are installed too). e.g.
+# It specifies global settings that are used to build Go programs:
+#
+# - Go toolchain to use, e.g.
 #
 #   [gowork]
-#   install =
-#       lab.nexedi.com/kirr/neo/go/...
-#       github.com/pkg/profile
-#       golang.org/x/perf/cmd/benchstat
+#   golang = ${golang1.15:location}
 #
-# For Cgo support pkg-config is made pre-available by gowork, and users
-# should list paths where to search for pkg-config files, e.g. this way:
+# - For Cgo support pkg-config is made pre-available by gowork, and users
+#   should list paths where to search for pkg-config files, e.g. this way:
 #
 #   [gowork]
 #   cpkgpath =
 #       ${sqlite3:location}/lib/pkgconfig
 #       ${zlib:location}/lib/pkgconfig
 #
-# It is also possible to specify Go build flags used for compilation e.g. this way:
+# - It is also possible to specify Go build flags used for compilation e.g. this way:
 #
 #   [gowork]
 #   buildflags = -race
 #
+#
+# Users should add `install` field to [gowork] to describe packages they want to
+# be installed (+ automatically their dependencies are installed too). e.g.
+#
+#   [gowork]
+#   install =
+#       lab.nexedi.com/kirr/neo/go/...
+#       github.com/pkg/profile
+#       golang.org/x/perf/cmd/benchstat
+#
+#
 # ${go:exe} is standalone executable that runs go in activated gowork environment.
 [go]
 recipe  = slapos.recipe.template:jinja2