Update CONTRIBUTING.md подчистил формулировки

Author: mmalferov

CONTRIBUTING.md

@@ -2,13 +2,14 @@
 
 ## Оформление
 
-- Символ отступа — пробел. Табуляция в файлах с расширением`.xml` спровоцирует ошибку.
+- Символ отступа — пробел; табуляция в файлах с расширением`.xml` спровоцирует ошибку. В XML-документах пробелы в конце строк тоже вызовут ошибку.
 - В документации пишут букву `ё`, чтобы исключить риск двойного прочтения.
+- При оформлении текстов соблюдают правила типографики: пишут тире, кавычки-ёлочки, сокращения в конструкциях наподобие `т. п.` или `т. д.` разделяют пробелом, соблюдают правила наращения числительных и т. д.
 
 ## Рекомендации по переводу
 
-Комментарии к коду требуется переводить;
-описание вывода наподобие `echo "You reload page $num times";` — тоже переводится.
+Комментарии к примерам кода переводят на русский язык;
+описание вывода наподобие `echo "You reload page $num times";` — тоже переводится. Текст ошибок и исключений не переводится.
 
 Исключение: английские слова в коде не переводятся, если перевод на русский язык изменит поведение функции, например,
 `strtolower("Alex") === "alex"`, но `strtolower("Алексей") !== "алексей"`.
@@ -22,8 +23,8 @@
 который описывает рекомендация [PER](https://www.php-fig.org/per/coding-style/),
 даже если потребуется изменить форматирование примера оригинальной документации.
 
-Оригинальный текст переводят предельно точно, отступления допускаются только для сохранения семантики, если буквальный перевод исказит смысл.
-При неточных или ошибочных формулировках в исходной документации вначале через запрос на слияние исправляют английскую версию, а только потом обновляют русскую.
+Оригинальный текст переводят _предельно точно,_ отступления допускаются только для сохранения семантики, если буквальный перевод исказит смысл.
+При неточных или ошибочных формулировках в исходной документации вначале исправляют английскую версию путём отправки запроса на слияние, а только потом обновляют русскую.
 
 ## Актуализация перевода
 
@@ -245,43 +246,41 @@ php phd/render.php --docbook doc-base/.manual.xml --package PHP --format xhtml
 | PHP_VERSION                     | Константа PHP_VERSION                                                 |
 | `var_dump()`                      | Функция `var_dump()`                                                |
 
-Одного уточнения хватит, если в предложении или коротком абзаце термин встречается больше одного раза, по смыслу.
+Одного уточнения достаточно, если в предложении или коротком абзаце термин встречается больше одного раза, по смыслу.
 При добавлении уточняющего слова дайте точное определение. Для термина `$_SERVER` доступны
 уточнения: «Переменная $_SERVER», «Глобальная переменная $_SERVER» или «Суперглобальная переменная $_SERVER» — лучше предпочесть последнее.
 
 ## Параметры и аргументы
 
-Параметр — член функции, который принадлежит функции, составляет сигнатуру функции или метода.
+Параметр — неотъемлемая часть сигнатуры функции или метода.
 Аргумент — значение, которое передают в функцию или метод «снаружи», чтобы определить значение параметра.
-Аргумент допускается передавать в функцию, передать в функцию параметр — нельзя, поскольку он уже находится «внутри» функции.
+Аргумент допускается передавать в функцию, передать параметр — невозможно, поскольку параметр — «внутренняя часть» функции.
 
-Участники перевода руководствуются этими разъяснениями, даже если в оригинальной документации «параметры»
+Участники перевода руководствуются логикой передачи аргументов и приёма аргументов параметрами функции, даже если в оригинальной документации «параметры»
 и «аргументы» употребили некорректно.
 
 ## Скобки
 
-Скобки затрудняют и замедляют чтение. Читатель «спотыкается» о скобки. Но без скобок нельзя обойтись. «В скобки заключают
-слова и предложения, вставляемые в предложение с целью пояснения или дополнения высказываемой мысли, а также
-для каких-либо добавочных замечаний» — гласят правила русского языка.
+Пояснения или добавочные замечания в предложении стараются не обрамлять скобками; скобки затрудняют и замедляют чтение, заставляют читателя «спотыкаться». Лучше вынести высказывание за скобки или в отдельное предложение.
 
-При переводе <em>не нужно</em> брать в скобки названия параметров.
+При переводе названия параметров _не берут_ в скобки.
 
 Например:
 
 > Функция больше не поддерживает передачу разделителя `<parameter>separator</parameter>` после массива `<parameter>array</parameter>`.
 
 В примере названия параметров — полноценные и равноправные члены предложения.
 
-Названия типов <em>нужно</em> брать в скобки.
+При этом названия типов _обрамляют_ скобками.
 
 Например:
 
 > Функция возвращает строку (`<type>string</type>`).
 
-В этом примере слово string (вместе с тегами) взяли в скобки, потому что слово поясняет,
+В примере слово `string` вместе с тегами взяли в скобки, потому что слово поясняет,
 что «строка», кроме словарного значения, означает тип данных.
 
-Старайтесь избавиться от скобок, если уместно (если это не часть примера или выражения и т. д.),
+Старайтесь избавляться от скобок, если уместно и если скобки — не часть примера или выражения,
 даже если в исходной документации слова или предложения указали в скобках.
 
 Точку ставят после закрывающей скобки, если слова в скобках — часть предложения (как в этом примере).