Add a guideline for using dashes (#2623)

Co-authored-by: Nick Volynkin <[email protected]>
Co-authored-by: Alexander Turenko <[email protected]>

Author: 3 people

doc/contributing/docs/localization/guide.rst

@@ -45,7 +45,7 @@ We don’t want our audience to feel confused, so we prefer newer terms.
 We also provide the English equivalent for a term
 if it is used in the article for the first time.
 
-If you feel like the older Russian term may sound more familiar for a part of the audience
+If you feel like an older Russian term may sound more familiar for a part of the audience
 (for example, those with a math background),
 consider adding it in parentheses along with the English equivalent.
 Don’t repeat the parentheses throughout the text.
@@ -132,7 +132,7 @@ Prefer verbs over verbal nouns,
 and don’t use «являться» and «осуществляться» unless it’s absolutely necessary.
 
 To learn how to clear your Russian texts of bureaucratese,
-check `Timur Anikin's training The Writing Dead <https://www.timuroki.ink/thewritingdead>`_.
+check `Timur Anikin's training "The Writing Dead" <https://www.timuroki.ink/thewritingdead>`_.
 
 ..  container:: table
 
@@ -145,7 +145,7 @@ check `Timur Anikin's training The Writing Dead <https://www.timuroki.ink/thewri
         *   -   Сообщение исчезнет, как только вы покинете данную страницу.
             -   Сообщение исчезнет, как только вы покинете страницу.
         *   -   Проверка истечения срока действия паролей производится раз в 30 минут.
-            -   Система раз в 30 минут проверяет, не истек ли срок действия паролей.
+            -   Раз в 30 минут система проверяет, не истек ли срок действия паролей.
 
 Consistency
 ~~~~~~~~~~~

doc/contributing/docs/style.rst

@@ -1,4 +1,3 @@
-
 Language and style
 ==================
 
@@ -174,13 +173,39 @@ Spelling and punctuation
 US vs British spelling
 ~~~~~~~~~~~~~~~~~~~~~~
 
-We use the US English spelling.
+Use the US English spelling.
 
 Check your spelling and punctuation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Consider checking spelling, grammar, and punctuation with special tools.
 
+Dashes
+~~~~~~
+
+Special symbols like dashes, quotation marks, and apostrophes look the same
+across all Tarantool documentation in a single language.
+This is because the documentation :doc:`builder </contributing/docs/build/>`
+renders specific character sequences in the source into correct typographic characters.
+
+Type three hyphens (``---``) to insert an em dash (---)
+and two hyphens (``--``) for an en dash (--).
+The following rules apply:
+
+*   The longer **em dash** ``---`` is used to separate extra information or mark a break in a sentence.
+*   The shorter **en dash** ``--`` is used to mark ranges (for example, 4--16 GB or Dover--Calais crossing).
+
+Don't use a single hyphen as a dash. Don't add spaces on either side of a dash. 
+
+When indicating a range like ``code element 1``\--``code element 2``, escape the series of hyphens using
+`character-level inline markup <https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#character-level-inline-markup-1>`_. 
+Otherwise, the RST interpreter will perceive the dash as part of the RST syntax:
+
+..  code-block:: rst
+
+    ``box.begin()``\--``box.commit()``
+
+
 Ending punctuation in lists and tables
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~