Connectors: Go tutorial - update per TW review

Author: andreyaksenov

doc/code_snippets/snippets/connectors/go/hello.go

@@ -11,6 +11,7 @@ import (
 )
 
 func main() {
+    // Connect to the database
 	ctx, cancel := context.WithTimeout(context.Background(), time.Second)
 	defer cancel()
 	dialer := tarantool.NetDialer{
@@ -28,7 +29,8 @@ func main() {
 		return
 	}
 
-	// Interacting with the database
+	// Interact with the database
+	// ...
 	// Insert data
 	tuples := [][]interface{}{
 		{1, "Roxette", 1986},

doc/how-to/getting_started_go.rst

@@ -5,7 +5,7 @@ Connecting from Go
 
 **Examples on GitHub**: `sample_db <https://github.com/tarantool/doc/tree/latest/doc/code_snippets/snippets/connectors/instances.enabled/sample_db>`_, `go <https://github.com/tarantool/doc/tree/latest/doc/code_snippets/snippets/connectors/go>`_
 
-The tutorial shows how to use the 2.x version of the `go-tarantool <https://github.com/tarantool/go-tarantool>`__ library to create a Go application that connects to a remote Tarantool instance, performs CRUD operations, and executes a stored procedure.
+The tutorial shows how to use the `go-tarantool <https://github.com/tarantool/go-tarantool>`__ 2.x library to create a Go application that connects to a remote Tarantool instance, performs CRUD operations, and executes a stored procedure.
 You can find the full package documentation here: `Client in Go for Tarantool <https://pkg.go.dev/github.com/tarantool/go-tarantool/v2>`__.
 
 
@@ -24,7 +24,7 @@ Sample database configuration
 Starting a sample database application
 --------------------------------------
 
-Before creating and starting a client Go application, you need to run the :ref:`sample_db <getting_started_net_box_sample_db>` application using ``tt start``:
+Before creating and starting a client Go application, you need to run the :ref:`sample_db <getting_started_net_box_sample_db>` application using :ref:`tt start <tt-start>`:
 
 .. code-block:: console
 
@@ -94,19 +94,19 @@ Connecting to the database
 
     ..  literalinclude:: /code_snippets/snippets/connectors/go/hello.go
         :language: go
-        :start-after: func main()
-        :end-at: // Interacting with the database
+        :start-at: // Connect to the database
+        :end-before: // Insert data
         :dedent:
 
     This code establishes a connection to a running Tarantool instance on behalf of ``sampleuser``.
     The ``conn`` object can be used to make CRUD requests and execute stored procedures.
 
 
 
-.. _getting_started_go_using_data_operations:
+.. _getting_started_go_manipulating_data:
 
-Using data operations
-~~~~~~~~~~~~~~~~~~~~~
+Manipulating data
+~~~~~~~~~~~~~~~~~
 
 .. _getting_started_go_inserting_data:
 
@@ -272,8 +272,8 @@ Starting a client application
 
 .. _getting_started-go-comparison:
 
-Feature comparison
-------------------
+Go connectors feature comparison
+--------------------------------
 
 There are two more connectors from the open-source community:
 

doc/how-to/getting_started_net_box.rst

@@ -24,7 +24,7 @@ This section describes the :ref:`configuration <configuration_file>` of a sample
 
 -   The configuration contains one instance that listens for incoming requests on the ``127.0.0.1:3301`` address.
 -   ``sampleuser`` has :ref:`privileges <authentication-owners_privileges>` to select and modify data in the ``bands`` space and execute the ``get_bands_older_than`` stored function. This user can be used to connect to the instance remotely.
--   ``myapp.lua`` defines how data is stored in a database and includes a stored function.
+-   ``myapp.lua`` defines the data model and a stored function.
 
 The ``myapp.lua`` file looks as follows: