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},
@@ -61,7 +63,7 @@ func main() {
 	if err != nil {
 		fmt.Println("Got an error:", err)
 	}
-	fmt.Println("Tuple selected the primary key value:", data)
+	fmt.Println("Tuple selected by the primary key value:", data)
 
 	// Select by secondary key
 	data, err = conn.Do(
@@ -74,7 +76,7 @@ func main() {
 	if err != nil {
 		fmt.Println("Got an error:", err)
 	}
-	fmt.Println("Tuple selected the secondary key value:", data)
+	fmt.Println("Tuple selected by the secondary key value:", data)
 
 	// Update
 	data, err = conn.Do(

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:
 
@@ -142,15 +142,15 @@ To get a tuple by the specified primary key value, use ``NewSelectRequest()`` to
 ..  literalinclude:: /code_snippets/snippets/connectors/go/hello.go
     :language: go
     :start-at: // Select by primary key
-    :end-at: Tuple selected the primary key value
+    :end-at: Tuple selected by the primary key value
     :dedent:
 
 You can also get a tuple by the value of the specified index by using ``Index()``:
 
 ..  literalinclude:: /code_snippets/snippets/connectors/go/hello.go
     :language: go
     :start-at: // Select by secondary key
-    :end-at: Tuple selected the secondary key value
+    :end-at: Tuple selected by the secondary key value
     :dedent:
 
 
@@ -260,8 +260,8 @@ Starting a client application
         [[2 Scorpions 1965]]
         [[3 Ace of Base 1987]]
         [[4 The Beatles 1960]]
-        Tuple selected the primary key value: [[1 Roxette 1986]]
-        Tuple selected the secondary key value: [[4 The Beatles 1960]]
+        Tuple selected by the primary key value: [[1 Roxette 1986]]
+        Tuple selected by the secondary key value: [[4 The Beatles 1960]]
         Updated tuple: [[2 Pink Floyd 1965]]
         Replaced tuple: [[1 Queen 1970]]
         Deleted tuple: [[5 The Rolling Stones 1962]]
@@ -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: