diff --git a/doc/sphinx/book/box/box_index.rst b/doc/sphinx/book/box/box_index.rst
index 46967180ec9ca3e1754518f03613bb262478c4d3..3e57d9587670b3e2c8c21a1a0c312eb5da51c3d5 100644
--- a/doc/sphinx/book/box/box_index.rst
+++ b/doc/sphinx/book/box/box_index.rst
@@ -636,9 +636,9 @@ is Rectangle#2", and "Rectangle#3 is entirely inside Rectangle#2".
 
 Now let us create a space and add an RTREE index.
 
-    :codebold:`s = box.schema.create_space`
-    :codebold:`i = s:create_index('primary',{type='HASH',parts={1,'NUM'}})`
-    :codebold:`r = s:create_index('spatial',{type='RTREE',unique=false,parts={2,'ARRAY'}})`
+    | :codebold:`s = box.schema.create_space('rectangles')`
+    | :codebold:`i = s:create_index('primary',{type='HASH',parts={1,'NUM'}})`
+    | :codebold:`r = s:create_index('spatial',{type='RTREE',unique=false,parts={2,'ARRAY'}})`
 
 Field#1 doesn't matter, we just make it because we need a primary-key index.
 (RTREE indexes cannot be unique and therefore cannot be primary-key indexes.)
@@ -646,17 +646,17 @@ The second field must be an "array", which means its values must represent
 {x,y} points or {x1,y1,x2,y2} rectangles. Now let us populate the table by
 inserting two tuples, containing the coordinates of Rectangle#2 and Rectangle#4.
 
-    :codebold:`s:insert{1, {3,5,9,10}}`
-    :codebold:`s:insert{2, {10,11}}`
+    | :codebold:`s:insert{1, {3,5,9,10}}`
+    | :codebold:`s:insert{2, {10,11}}`
 
 And now, following the description of `RTREE iterator types`_, we can search the
 rectangles with these requests:
 
 .. _RTREE iterator types: rtree-iterator_
 
-    :codebold:`r:select({10,11,10,11},{iterator='EQ'})   -- Request#1 (returns 1 tuple)`
-    :codebold:`r:select({4,7,5,9},{iterator='GT'})       -- Request#2 (returns 1 tuple)`
-    :codebold:`r:select({1,2,3,4},{iterator='NEIGHBOR'}) -- Request#3 (returns 2 tuples)`
+    | :codebold:`r:select({10,11,10,11},{iterator='EQ'})   -- Request#1 (returns 1 tuple)`
+    | :codebold:`r:select({4,7,5,9},{iterator='GT'})       -- Request#2 (returns 1 tuple)`
+    | :codebold:`r:select({1,2,3,4},{iterator='NEIGHBOR'}) -- Request#3 (returns 2 tuples)`
 
 Request#1 returns 1 tuple because the point {10,11} is the same as the rectangle
 {10,11,10,11} ("Rectangle#4" in the picture). Request#2 returns 1 tuple because
diff --git a/doc/sphinx/reference/shard.rst b/doc/sphinx/reference/shard.rst
index dbb9ec5ac625fcd54961c77b7c4f3836e59ea9bb..25534b05216fed9125cd742a433da4a4a1e73d3a 100644
--- a/doc/sphinx/reference/shard.rst
+++ b/doc/sphinx/reference/shard.rst
@@ -19,7 +19,7 @@ The shard package distributes according to a hash algorithm,
 that is, it applies a hash function to a tuple's primary-key value
 in order to decide which shard the tuple belongs to.
 The hash function is `consistent`_
-so that changing the number of tuples will not affect results for many keys.
+so that changing the number of servers will not affect results for many keys.
 The specific hash function that the shard package uses is
 guava.digest in the :codeitalic:`digest` package. |br|
 **Queue** ...
diff --git a/doc/sphinx/reference/tarantool.rst b/doc/sphinx/reference/tarantool.rst
index 526c922917200f9e7703209dba22113004ea8c5a..58e7e65690fc1ced67b5cc56060587c31f816664 100644
--- a/doc/sphinx/reference/tarantool.rst
+++ b/doc/sphinx/reference/tarantool.rst
@@ -8,9 +8,10 @@ By saying :code:`require('tarantool')`, one can answer
 some questions about how the tarantool server was built,
 such as "what flags were used", or "what was the version
 of the compiler". Additionally one can see the uptime
-and the server version and the process id, but those
-information items are more commonly accessed with
-:func:`box.info`.
+and the server version and the process id. Those
+information items can also be accessed with
+:func:`box.info` but use of the tarantool package is
+recommended.
 
     | EXAMPLE
     | :codenormal:`tarantool>` :codebold:`tarantool = require('tarantool')`