Add SQL Beginners' Guide to How-to

Author: patiencedaur

doc/how-to/sql/index.rst

@@ -1,8 +1,12 @@
 SQL guides
 ==========
 
+This section contains hands-on SQL guides.
+You might also want to read the in-depth :ref:`SQL reference <reference_sql>`.
+
 ..  toctree::
     :maxdepth: 1
 
+    sql_beginners_guide
     sql_tutorial
     improving_mysql

doc/reference/reference_sql/sql_beginners_guide.rst renamed to doc/how-to/sql/sql_beginners_guide.rst

@@ -788,3 +788,5 @@ The rules state that it should be impossible to use a low-level language to bypa
 integrity as defined in the relational-level language.
 In Tarantool's case, this is not true, for example one can execute a request
 with Tarantool's NoSQL to violate a foreign-key constraint that was defined with Tarantool's SQL.
+
+To learn more about SQL in Tarantool, check the :ref:`reference <reference_sql>`.

doc/reference/reference_sql/index.rst

@@ -14,7 +14,6 @@ This reference covers all the SQL statements and clauses supported by Tarantool.
     :numbered: 0
 
     sql
-    sql_beginners_guide
     sql_user_guide
     sql_statements_and_clauses
     sql_plus_lua

doc/reference/reference_sql/sql.rst

@@ -50,8 +50,7 @@ rather than starting with a NoSQL DBMS and adding syntax to it.
 What Tarantool's SQL manual delivers
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The following five parts of this document are: |br|
-The :ref:`SQL Beginners' Guide <sql_beginners_guide>` explains the basics of relational database management and SQL in particular. |br|
+The following parts of this document are: |br|
 The :ref:`SQL User Guide <sql_user_guide>` explains "How to get Started" and explains the terms and the syntax elements that
 apply for all SQL statements. |br|
 The :ref:`SQL Statements and Clauses <sql_statements_and_clauses>` guide explains, for each SQL statement, the format and the rules
@@ -61,3 +60,5 @@ and using the same database objects in both SQL and Lua. |br|
 The :ref:`SQL Features <sql>` list shows how the product conforms with the mandatory features of the SQL standard.
 
 Users are expected to know what databases are, and experience with other SQL DBMSs would be an advantage.
+To learn about the basics  of relational database management and SQL in particular,
+check the :ref:`SQL Beginners' Guide <sql_beginners_guide>` in the :ref:`How-to guides <how-to>` section.