fixes gh-1737 describe the new way to write 'parts' option while creating indexes

Author: Onvember

doc/reference/reference_lua/box_space/create_index.rst

@@ -152,6 +152,21 @@ On this page:
               name: primary
             ...
 
+        ..  NOTE::
+
+            Since version :doc:`2.7.1 </release/2.7.1>` it is allowed to omit
+            extra braces in index definition if it consists of only one part.
+
+            ..  code-block:: lua
+
+                --old way with extra braces (still correct)
+                my_space:create_index('one_part_idx', {parts = {{1, 'unsigned'}}})
+
+                --new way
+                my_space:create_index('one_part_idx', {parts = {1, 'unsigned'}})
+
+
+
 .. _details_about_index_field_types:
 
 .. _box_space-index_field_types:

doc/release/2.7.1.rst

@@ -39,7 +39,8 @@ Core
 ~~~~
 
 -   Now it is allowed to define an index without extra braces when there
-    is only one part: ``parts = {field1, type1, ...}`` (gh-2866).
+    is only one part: ``parts = {field1, type1, ...}`` (gh-2866). Read more in
+    the note after the example in :doc:`/reference/reference_lua/box_space/create_index`.
 -   Bitset index now supports the varbinary type (gh-5392).
 -   Index-related options now can’t be specified in their definition due
     to a more pedantic key-parts verification (gh-5473).