Орфография, пунктуация и символы

Буква «ё»

Буква «ё» пишется везде, где она нужна, даже если её нет в интерфейсе.

Тире и дефис

Знак препинания	Где используется	Пример
Длинное тире	Между единицами измерения	50 г — 10 кг
Короткое тире	Между числами	20–30 мм, 2–29 фев.
Дефис	C наращёнными числительными, в номере телефона при выделении по две цифры с конца и в диапазоне дней недели	5-й, +7 495 123-45-67, пн. - пт.

Кавычки

Используются «ёлочки».

В кавычки заключается всё, что имеет родовое слово вне зависимости от расположения в тексте.

Исключения:

• имена собственные без родового слова, например, Госуслуги;
• названия кликабельных элементов интерфейса;
• ссылки;
• маркированные списки с описанием статусов, параметров, показателей.

Пример списка с описанием статусов

Статусы после отправки:

• Передаётся в доставку — товары собраны и передаются в доставку.
• В пути — транспортировка товаров до пункта выдачи, постамата или склада, с которого его заберёт курьер Ozon.
• У курьера — заказ находится у курьера.
• Ожидает получения — заказ готов к получению.
• Доставлено — курьер доставил вам заказ.
• Получен — вы получили заказ в пункте выдачи или постамате.
• Отменено — вы отменили заказ, не получили его или вернули.

Пример списка с описанием параметров

Отчет содержит строки:

• Дата возврата или отмены — дата отмены заказа или оформления заявки на возврат.
• Номер отправления — номер отправления, который отображается в личном кабинете.
• Артикул товара — ваш артикул товара.
• Ozon SKU ID — уникальный ID товара на Ozon.
• Наименование товара — название товара в карточке.
• Количество возвращаемых товаров — сколько позиций из заказа вернул покупатель.
• Стоимость товара — цена, по которой был заказан товар.
• Статус возврата — статус отправления на момент загрузки отчёта.
• Дата статуса — дата последнего обновления статуса возврата.
• Причина возврата или отмены — почему покупатель отменил или вернул заказ.
• Комментарий покупателя — дополнительная информация по возврату.
• Целевое место назначения — название склада, пункта выдачи или СЦ, куда направляется возврат.
• Местоположение — название пункта выдачи, склада или СЦ, в котором находится возврат или отмена.

Пример списка с описанием показателей

Чтобы посмотреть показатели на графике, переключайтесь между показателями:

• Расход — общие затраты на продвижение.
• Продажи в продвижении — сумма продаж, которые вы получили в результате продвижения, включая продажи моделей товаров, объединённых в одну карточку. Учитываем все оплаченные заказы, включая отмены и возвраты.
• Продано товаров — количество товаров, которые вы продали в результате продвижения, с учётом моделей товаров, объединённых в одну карточку. Учитываем все оплаченные заказы, включая отмены и возвраты.
• ДРР в продвижении — отношение расходов на продвижение к сумме продаж в продвижении, включая продажи моделей товаров, объединённых в одну карточку.
• Показы — сколько показов принесло продвижение.
• Клики — количество кликов, которое получили товары в результате продвижения с учётом добавлений в корзину или избранное.
• Добавление в корзину — сколько раз добавили ваш товар в корзину за период продвижения, с учётом моделей, объединённых в одну карточку.
• CTR — отношение числа кликов к числу показов.
• Конверсия в корзину — отношение количества добавлений в корзину к количеству кликов по товару в продвижении.
• Средняя стоимость клика — соотношение расходов на продвижение к количеству кликов по товарам в продвижении.
• Затраты на заказ — соотношение затрат на продвижение к количеству заказов, полученных в результате продвижения.
• ДРР — отношение расходов на продвижение к стоимости всех заказанных товаров — с продвижением и без него. Не учитываем модели, объединённые в одну карточку. Метрика доступна только для разреза данных по типу продвижения.

Точка и точка с запятой

Точка ставится:

• в конце предложений в тексте статьи,
• в конце предложений в плашках.

Точка не ставится:

• в конце названия статей,
• в конце заголовков,
• в описаниях статей.

Если в предложении есть точка с запятой, значит, оно слишком длинное и его нужно разделить на два.

Подробнее о правилах пунктуации в списках и таблицах

Скобки

В тексте не используются скобки, в том числе для уточнения информации и приведения примеров. Если текст в скобках важный, его нужно вынести в отдельное предложение. Если нет, его нужно убрать.

❌	✅
Цены за доставку могут быть разными (если сравнивать обычную подписку и Premium).	Цены за доставку могут быть разными, если сравнивать обычную подписку и Premium.
В тексте баннера и на странице перехода не должно быть прилагательных в превосходной степени (например, «лучший», «самый удобный»).	В тексте баннера и на странице перехода не должно быть прилагательных в превосходной степени. Например, «лучший», «самый удобный».

Числа и числительные

Числа от нуля до девяти пишутся текстом, за исключением:

Ситуация	Пример
Период времени	1–3 часа
Большие круглые числа	1 млн, 1 млрд
Акцент на цифрах	3 рубля за 1 клик

Числа, начиная с пятизначных, отбиваются неразрывными пробелами на трёхзначные разряды, например, 10 000.

Наращённые числительные

Наращивать можно только порядковые числительные. Количественные числительные наращивать нельзя.

❌	✅
Не более 4-х дней, 20-ка, 3-ка, 5-ка	В 38-й раз, на 49-м этаже

Подробнее о буквенных наращениях в «Грамоте»

Дробные числа

Десятичные дроби отделяются от целых чисел запятой.

Дата и время

Дни недели

В диапазоне дней недели используются сокращённые названия дней с точкой в конце. Между ними ставится дефис, который отбивается пробелами с двух сторон.

Пример

Рабочие дни: пн. - пт.

Единицы измерения

В тексте используются следующие сокращения:

• длина: м, см, км
• масса: г, кг, т
• температура: °C
• размер предмета или изображения: 20 × 30 мм
• размер файла: ГБ, МБ
• количество: шт., тыс.
• площадь: кв. м

Валюта

Знак валюты ставится после цифры.

В тексте название валюты не сокращается. В таблицах и формулах, где нужно экономить место, «рубли» сокращаются до «руб.», а названия других валют пишутся полностью. Если необходимо использовать знак валюты, мы пишем число + знак валюты.

Пример: 10 ₽, 10 $.

Соотношение сторон

При указании соотношения сторон используется двоеточие, которое отбивается с двух сторон неразрывными пробелами.

Пример: Фото формата 3 : 4.

Исключение — названия элементов интерфейса, в которых вместо двоеточия используется «х».

Пример: Заполните поля на вкладке Фото 3х4.

Если в документации указывается не соотношение сторон, а конкретные размеры предмета, то используется знак «×». Он отбивается с двух сторон неразрывными пробелами.

Неразрывный пробел

Используется после предлогов, союзов, местоимений, междометий, чисел и перед единицами измерения, чтобы они не переносились на следующую строку.

Номера телефонов

Формат написания телефонных номеров:

• Мобильные номера: +7 495 123-45-67. Код страны указывается в стандартном международном формате.
• Бесплатные номера: 8 800 123-45-67.

Восклицательные знаки

Избегаем восклицательных знаков, чтобы не давать документации эмоциональной окраски.

Процент, номер и параграф

Знак процента пишется слитно с числом, например, «Скидка 15%». Не заменяем слово «процент» символом, если он употребляется без чисел, например, «большой процент».

После №, § и °С всегда ставится пробел.

Пример: № 3.

После числа со знаками °, ′, ′′, % пробел не ставится.

Географические названия

Географические названия и топонимы пишутся с заглавной буквы.

Пример: Северный Кавказ, Оренбургская область, город Москва.

Слова, обозначающие родовые географические объекты, названия сторон света и прилагательные, образованные от них, кроме случаев, когда это часть топонима, пишутся со строчной буквы.

Пример: остров Русский, западный.

Форматы и расширения файлов

Форматы файлов пишутся заглавными буквами и на латинице: GIF, JPEG, DOC, MP3. Если в статье есть ссылка на скачивание файла, его формат всегда прописывается рядом с названием файла в скобках.

Расширения файлов пишутся с точкой и строчными буквами: .gif, .jpeg, .jpg, .doc, .mp3. Расширения используются, если в статье указывается имя файла.

❌	✅
Загрузите файл в формате .pdf.	Загрузите файл в формате PDF.
Загрузите файл example.PDF.	Загрузите файл example.pdf.
Скачать файл	Скачать файл (PDF)
Скачать	Скачать PDF-файл