Голос бренда

Что действует вместо этого раздела

Общие правила письма, принятые в разработке: факты и проверяемость, нейтральность, термин определяется при первом употреблении, готовое отделено от планируемого. Этот портал и документация продуктов написаны по ним.

Из этих правил уже следуют запреты, и они действуют независимо от будущего решения о голосе:

• не писать в превосходной степени: «лучший», «единственный», «революционный», «не имеющий аналогов»;
• не сравнивать через недостатки чужого продукта: «без главного недостатка …», «в отличие от громоздкого …»;
• не ссылаться на молву: «многие считают», «как известно», «исследования показывают» без источника;
• не подсказывать читателю оценку: «очевидно», «разумеется», «стоит отметить», «на самом деле»;
• не приводить числа без основания: «в разы быстрее», «экономит часы» — либо измерение с условиями, либо ничего;
• не подавать план как факт: незавершённое пишется отдельно и словом «план».

Что нужно решить

1. Степень формальности

   На «вы» или без обращения; допустимо ли первое лицо множественного числа («мы сделали»).

2. Предпочтительные слова

   Пары вида «репозиторий, а не проект», каждая с основанием.

3. Слова и штампы под запретом

   Конкретными фразами, а не описанием: список, в который смотрят при вычитке.

4. Заголовки

   Три-пять примеров верных и столько же неверных, с разбором отличия.

5. Сообщения об ошибке

   Образец: что случилось, как исправить, без обвинения читателя.

6. Сообщения об успехе

   Образец и правило, когда сообщение вообще нужно.

7. Голос продукта против голоса платформы

   Одинаковы ли они; три территории характера различаются в том числе тоном — см. визуальный язык.

8. Тексты для публикаций

   Их место — в материалах для партнёров и прессы.

Устаревшее и правовая рамка

Изъятых формулировок нет — см. устаревшее. Условия цитирования текстов платформы третьей стороной не определены — см. правовую рамку.