Skill: talkstream/ru-text (version 1.6.0)

--- name: ru-text description: > Use when writing, editing, or reviewing Russian-language text, or when user mentions ru-text. Covers typography, info-style, editorial, UX writing, business correspondence. Auto-activates on Russian text output. metadata: openclaw: always: true emoji: "\U0001F4DD" homepage: "https://ru-text.org" --- # ru-text — Russian Text Quality Independent Russian text quality reference by Arseniy Kamyshev. With gratitude to the authors whose work shaped modern Russian text standards. Credits and recommended reading: `${CLAUDE_PLUGIN_ROOT}/skills/ru-text/references/sources.md` **Style priority**: if the user explicitly requests a specific style (casual, academic, SEO, literary, etc.), their prompt overrides these default rules where they conflict. These rules are defaults, not mandates. ## Always-On: Typography Apply these rules to ALL Russian text output without exception. | Rule | Wrong | Correct | |---|---|---| | Primary quotes: guillemets | "текст" | «текст» | | Nested quotes: lapki | «"вложенные"» | «„вложенные“» | | Em dash with spaces | слово - слово | слово — слово | | En dash for ranges, no spaces | 10-15 дней | 10–15 дней | | NBSP after single-letter prepositions | в начале (breakable) | в\u00A0начале | | Ellipsis: single character | ... | … | | Digit groups with thin spaces | 1000000 | 1 000 000 | | Decimal comma (not dot) | 3.14 | 3,14 | | Ordinal with hyphen | 1ый, 2ой | 1-й, 2-й | | Numero sign | No. 5, #5 | № 5 | | Abbreviations with NBSP | т.д., т.е. | т. д., т. е. | | Ruble symbol after number | 1500 руб | 1 500 ₽ | Full typography reference: `${CLAUDE_PLUGIN_ROOT}/skills/ru-text/references/typography.md` `/ru-text:ru-score` — text quality score (0–10, 5 dimensions). ## Top Stop-Words (remove or replace) | Stop-word | Replace with | |---|---| | является | — (dash) or restructure | | осуществлять | делать, проводить | | в настоящее время | сейчас | | данный | этот | | определённый | (name the specific thing) | | произвести оплату | оплатить | | высококачественный | (name the specific quality) | | был осуществлён | (active voice + actor) | | на сегодняшний день | сегодня | | в целях | чтобы | Full stop-word catalog (97 entries): `${CLAUDE_PLUGIN_ROOT}/skills/ru-text/references/info-style.md` ## When to Load Reference Files Reference files: `${CLAUDE_PLUGIN_ROOT}/skills/ru-text/references/<filename>` If the path is not resolved, search: `Glob("**/ru-text/references/scoring.md")` and use the parent directory. | Task | File | |---|---| | Writing/editing articles, blog posts, SEO, content | info-style.md | | Interface text, buttons, errors, hints, microcopy | ux-writing.md | | Emails, messenger, business correspondence | business-writing.md | | Punctuation review, comma placement | editorial-punctuation.md | | Grammar, capitalization, agreement, pleonasms | editorial-grammar.md | | Finding and fixing text problems, diagnostics | anti-patterns.md | | Text scoring, quality assessment | scoring.md | | Credits, source attribution | sources.md | | Experience-based rules (dash overuse, etc.) | addenda.md | ## Quality Checklist Before delivering Russian text: - [ ] Quotes: «» primary, „" nested - [ ] Dashes: — in text, – in ranges, - only in compounds; max 1–2 per paragraph - [ ] NBSP after в, к, с, о, у, и, а - [ ] Ellipsis: … (single char) - [ ] Abbreviations: т. д., т. п. (with NBSP) - [ ] No double spaces, no space before punctuation

path: agents/gemini.yaml
content: interface:
  display_name: "ru-text"
  short_description: "Russian text quality — typography, info-style, editorial, UX writing, business correspondence"


path: agents/openai.yaml
content: interface:
  display_name: "ru-text"
  short_description: "Russian text quality — typography, info-style, editorial, UX writing, business correspondence"

policy:
  allow_implicit_invocation: true


path: references/addenda.md
content: # Addenda — rules added from usage experience

Rules below were NOT part of the initial distillation from 16 canonical sources.
They emerged from real editorial practice and are supported by academic references.
Kept separate for traceability: original corpus vs. experiential additions.

---

## AD-1. Excessive em dashes (избыточные тире)

**Problem:** multiple em dashes in a paragraph create choppy rhythm, monotony, and an affected (mannered) tone.

**Sources:**
- Chekhov: «Поменьше употребляйте курсивов и тире — это манерно»
- Rozental "Практическая стилистика": dashes should serve clear semantic function, not be default punctuation
- Gramota.ru: some writers abuse dashes; the 1956 Rules of Russian Orthography note both extremes
- Gorky, Dostoevsky used excessive dashes as INTENTIONAL literary device — not a model for non-literary prose
- Milchin/Cheltsova: restraint in editorial formatting

**Rules:**

AD-1.1. Limit to 1–2 em dashes per paragraph in non-literary prose. Three or more is a signal to restructure.

AD-1.2. Never use em dashes as default punctuation when a more precise mark exists:
- Explanation/enumeration → colon `:`
- Stronger pause between independent clauses → semicolon `;`
- Aside/clarification → parentheses `()`
- Complex sentence → restructure into two sentences

AD-1.3. Consecutive sentences with em dashes = monotonous pattern. Vary punctuation across sentences.

AD-1.4. "Dash between subject and predicate" (тире между подлежащим и сказуемым) is often skippable in conversational register — Rozental notes it's usually NOT placed in simple conversational-style sentences.

AD-1.5. Test for "mannered" tone (манерность): read aloud. If dashes create a staccato rhythm that feels artificial, replace some with other constructions.

**Replacement strategies:**

| Pattern with dash | Alternative | When to use alternative |
|---|---|---|
| Москва — столица России | Москва, столица России, … | Appositive, not emphasis |
| Это — важно | Это важно | No emphasis needed, conversational |
| Он пришёл — и замолчал | Он пришёл и замолчал | No dramatic pause needed |
| Результат — рост продаж | Результат: рост продаж | Explanation follows |
| Всё готово — можно начинать | Всё готово; можно начинать | Two independent clauses |
| Скилл — набор правил — помогает | Скилл (набор правил) помогает | Aside, not emphasis |


path: references/anti-patterns.md
content: # Russian Text Anti-Patterns

Catalog of common mistakes organized by severity. Format: wrong|correct.

## Contents
- [Critical: Typography (16 entries)](#critical-typography-16-entries)
- [Critical: Канцелярит и номинализация (32 entries)](#critical-канцелярит-и-номинализация-32-entries)
- [High: Vague Adjectives (11 entries)](#high-vague-adjectives-11-entries)
- [High: Passive Voice (10 entries)](#high-passive-voice-10-entries)
- [High: Sentence Bloat (15 entries)](#high-sentence-bloat-15-entries)
- [Medium: False Intensifiers (11 entries)](#medium-false-intensifiers-11-entries)
- [Medium: Tautology/Pleonasm (22 entries)](#medium-tautologypleonasm-22-entries)
- [Low: Anglicisms (11 entries)](#low-anglicisms-11-entries)
- [Low: Archaic (6 entries)](#low-archaic-6-entries)
- [Low: Overly Formal (5 entries)](#low-overly-formal-5-entries)
- [Summary](#summary)

## Critical: Typography (16 entries)

Full typography rules: see [typography.md](typography.md). Top 5 most frequent crimes:

Wrong|Correct
"кавычки" (straight)|«кавычки» (guillemets «ёлочки»)
Дефис вместо тире: "Москва - столица"|Москва -- столица (em-dash)
Три точки "..."|Многоточие … (U+2026, single glyph)
Знак номера: "No." или "#"|№ (знак номера)
CAPS LOCK ДЛЯ ВЫДЕЛЕНИЯ|**Полужирный** или *курсив*

Remaining 11: nested quotes, en-dash in ranges, double dashes, space before comma, no space after period, latin x vs multiplication sign, inconsistent ё, double spaces, tight % sign, (c) vs ©, minus vs em-dash in text. All covered in [typography.md](typography.md).

## Critical: Канцелярит и номинализация (32 entries)

Bureaucratic constructions and verb-hidden-inside-noun patterns. Named by K. Chukovsky, elaborated by N. Gal.

Wrong|Correct
Осуществлять деятельность|Работать
Произвести/производить оплату|Оплатить / Заплатить
Выполнить/осуществлять доставку|Доставить / Доставлять
Провести мероприятие|Организовать [конкретику]
В целях недопущения|Чтобы не допустить
Был осуществлён выход|Вышли
Производить полив|Поливать
Вопрос решается в рабочем порядке|Решим до [дата]
Имеет место быть|Есть / Произошло
Является обязательным условием|Обязательно
В настоящее время|Сейчас
На постоянной основе|Постоянно / Регулярно
В связи с тем, что|Потому что / Так как
По причине того, что|Потому что
С целью повышения|Чтобы повысить
Надлежащим образом|Хорошо / Правильно / Как нужно
Задействовать ресурсы|Использовать [что конкретно]
Находился в состоянии усталости|Устал
Нести ответственность|Отвечать (за)
Дать соответствующее указание|Поручить / Попросить
Осуществлять контроль|Контролировать
Принимать участие|Участвовать
Оказывать влияние|Влиять
Давать оценку|Оценивать
Вести наблюдение|Наблюдать
Проводить исследование|Исследовать
Производить ремонт|Ремонтировать / Чинить
Вести подготовку|Готовить / Готовиться
Совершать покупку|Покупать
Делать выводы|Заключать / Считать
Приносить извинения|Извиняться
Оказывать помощь|Помогать

## High: Vague Adjectives (11 entries)

Words that add volume but no information. If removing changes nothing -- delete.

Vague|Fix
Высококачественный продукт|Продукт [конкретное свойство: прочный, быстрый]
Оптимальное решение|Решение, которое [конкретное преимущество]
Инновационный подход|[Описание подхода]
Достаточно быстро|За 3 часа / К вечеру
Определённые трудности|[Названные трудности]
Соответствующие меры|[Конкретные действия]
Данный вопрос|Этот вопрос (or omit)
Ряд причин|Три причины: [1, 2, 3]
Определённым образом|[Описать, как именно]
Весьма существенно|На 40% / Вдвое
Комплексное решение|Решение, которое охватывает [что]

## High: Passive Voice (10 entries)

Passive hides the actor, making text evasive and bureaucratic.

Passive|Active
Было принято решение|Мы решили / Руководитель решил
Отчёт будет подготовлен|Ольга подготовит отчёт
Работа выполняется|Команда выполняет работу
Задача была поставлена|Иван поставил задачу
Ошибка была допущена|Мы допустили ошибку
Вопрос рассматривается|Анна рассматривает вопрос, ответит до пятницы
Проект был завершён|Команда завершила проект
Меры будут приняты|[Кто] сделает [что] до [когда]
Совещание проведено|Мы провели совещание
Информация доведена до сведения|Мы сообщили команде

## High: Sentence Bloat (15 entries)

Sentences that could be half as long with no loss of meaning.

Bloated|Concise
В связи с тем, что проект находится на завершающей стадии реализации|Проект почти завершён
На сегодняшний день не представляется возможным дать однозначный ответ|Пока не можем ответить точно
Мы хотели бы выразить надежду на то, что|Надеемся
По результатам проведённого анализа установлено, что|Анализ показал:
Необходимо обратить особое внимание на тот факт, что|Обратите внимание:
Данная информация носит конфиденциальный характер|Информация конфиденциальная
Если у вас возникнут дополнительные вопросы, вы можете обратиться|Если есть вопросы -- пишите
Мы придерживаемся мнения о том, что|Считаем, что
Является ключевым фактором, определяющим|Определяет / Главная причина
В рамках проводимых мероприятий по улучшению|Чтобы улучшить
Следует отметить тот немаловажный факт, что|Важно:
Исходя из совокупности имеющихся факторов|Учитывая [что именно]
На протяжении длительного периода времени|Долго / С [года] по [год]
Таким образом, подводя итог всему вышесказанному|Итого
По вопросу, касающемуся|По поводу / О

## Medium: False Intensifiers (11 entries)

Words that claim to amplify but weaken because they substitute for evidence.

False Intensifier|Fix
Абсолютно уникальный|Уникальный (or describe why)
Очень важно|Важно (or explain why it matters)
Крайне необходимо|Необходимо (or state consequences)
Максимально эффективно|Эффективно: [метрика]
Реально классный|[Конкретное достоинство]
Совершенно очевидно|Вот данные: ...
Буквально взорвал|[Конкретный результат]
Невероятно быстрый|Обрабатывает 10K запросов/сек
По-настоящему|[Remove or replace with facts]
Самый лучший|Лучший по [критерий]
Довольно-таки неплохой|Хороший / Достойный

## Medium: Tautology/Pleonasm (22 entries)

Tautology: same meaning repeated (масло масляное). Pleonasm: redundant word already contained in neighbor (подняться вверх).

Redundant|Fix
Свободная вакансия|Вакансия
Памятный сувенир|Сувенир
Прейскурант цен|Прейскурант
Народный фольклор|Фольклор
Своя автобиография|Автобиография
Впервые дебютировать|Дебютировать
Подняться вверх|Подняться
Спуститься вниз|Спуститься
В январе месяце|В январе
Совместное сотрудничество|Сотрудничество
Главный приоритет|Приоритет
Полностью завершить|Завершить
Другая альтернатива|Альтернатива
Внутренний интерьер|Интерьер
Ответная реакция|Реакция
Передовой авангард|Авангард
Период времени|Период
Полный аншлаг|Аншлаг
Краткое резюме|Резюме (в значении "итог")
Предупредить заранее|Предупредить
Масло масляное|(remove one word)
Спросить вопрос|Задать вопрос / Спросить

## Low: Anglicisms (11 entries)

Use Russian when it carries the same meaning. Some anglicisms have no precise equivalent -- those are fine.

Anglicism|Russian|When anglicism OK
Дедлайн|Срок / Крайний срок|IT context
Фидбэк|Обратная связь / Отзыв|Non-IT audience
Митинг|Встреча / Совещание|General business
Апрувить|Утвердить / Согласовать|Any formal text
Кейс|Случай / Пример / Ситуация|Legal/marketing term
Ворк-шоп|Мастерская / Практикум|General audience
Тимлид|Руководитель группы|Formal HR documents
Коллаборация|Сотрудничество|General text
Факап|Провал / Ошибка|Any non-slang text
Пушить (задачу)|Продвигать / Настаивать|Non-slang context
Сетапить|Настраивать|Non-slang context

## Low: Archaic (6 entries)

Words that make text sound pre-revolutionary.

Archaic|Modern
Сие|Это
Оный|Тот / Этот
Коим образом|Каким образом / Как
Ибо|Потому что / Так как
Дабы|Чтобы
Токмо|Только

## Low: Overly Formal (5 entries)

Official language where it creates distance and discomfort.

Formal|Appropriate
Разрешите поинтересоваться...|Подскажите, пожалуйста...
Прошу принять к сведению|Имейте в виду
Выражаю благодарность|Спасибо!
Настоящим подтверждаю|Подтверждаю / Да, всё верно
Имею честь сообщить|Расскажу / Хочу поделиться

## Summary

Severity|Category|Entries
Critical|Typography|16
Critical|Канцелярит и номинализация|32
High|Vague adjectives|11
High|Passive voice|10
High|Sentence bloat|15
Medium|False intensifiers|11
Medium|Tautology/pleonasm|22
Low|Anglicisms|11
Low|Archaic|6
Low|Overly formal|5
**Total**||**139**


path: references/business-writing.md
content: # Russian Business Writing Guide

Principles of clear, respectful, and effective written communication in Russian --
for email, messengers, and formal correspondence.

## Contents
- [A. Email Structure](#a-email-structure)
- [B. Messenger Etiquette](#b-messenger-etiquette)
- [C. Tone Management](#c-tone-management)
- [D. Clean Business Phrases](#d-clean-business-phrases)
- [E. Meeting Notes Structure](#e-meeting-notes-structure)
- [F. Saying No Respectfully](#f-saying-no-respectfully)
- [Sources](#sources)

---

## A. Email Structure

### Subject Line

Formula: **[action type] + topic**.

**Rules:**
1. One email = one topic. Two unrelated things = two emails.
2. Subject names the action: approve, review, respond, FYI.
3. Include project name or context if relevant.
4. Never leave subject empty.
5. Update subject when conversation topic shifts.

**Bad|Good:**

| bad|good |
|---|---|
| Вопрос|[Согласовать] Бюджет на Q3 |
| Срочно!!!|[До 15.03] Правки в договор с Альфа |
| Привет|[Ознакомиться] Новый регламент командировок |
| Без темы|[Ответить] Дата встречи по проекту Орион |
| Информация|[К сведению] Изменение графика работы офиса |
| Важно|[Утвердить] Макет лендинга до пятницы |
| Документы|[Проверить] Акт сверки за февраль |
| Напоминание|[Подписать до 20.03] Допсоглашение к договору |
| Предложение|[Обсудить] Партнёрство с LogiTech на 2026 |
| Просьба|[Выслать] Отчёт по трафику за март |
| re: re: re: fw:|[Решить] Выбор подрядчика: финальное голосование |
| Мысли|[Дать обратную связь] Прототип мобильного приложения |

### First Sentence

Pattern: greeting (short) + main point in sentence one. No filler.

| weak|strong |
|---|---|
| Добрый день! Как ваши дела? Хотел бы обсудить один момент...|Добрый день! Предлагаю перенести запуск на 20 марта -- нужна ещё неделя на тестирование. |
| Здравствуйте! Надеюсь, у вас всё хорошо. Пишу по поводу проекта...|Здравствуйте! Проект задерживается на 5 дней. Причина и план ниже. |

### Body
6. Use numbered/bulleted lists for multiple items.
7. Bold key terms and deadlines.
8. Paragraphs: 3–4 sentences max.
9. Attach files instead of pasting long content inline.
10. Referencing previous correspondence -- include the relevant quote.

### Closing Sentence

Last sentence answers: who does what, by when.

| weak|strong |
|---|---|
| Буду рад обсудить.|Прошу согласовать макет до 18.03. Правки -- до пятницы. |
| Жду вашего ответа.|Ольга, пришлите финальный текст до среды, 19 марта. |
| Надеюсь на понимание.|Если возражений нет до 15:00 пятницы, запускаем как есть. |

---

## B. Messenger Etiquette

1. **One message = greeting + question + context.** Never send "Привет" and wait. The recipient opens chat and finds nothing actionable.
2. **No voice messages** unless recipient explicitly agreed. If you must -- add text summary of key points.
3. **Thread replies in group chats (5+).** No threads? Prefix with topic: "[логистика] Отгрузка перенесена".
4. **Async by default.** No "???" after 10 min silence. Urgent = call.

### Channel Selection

| Channel|Use for|Not for |
|---|---|---|
| Email|Formal decisions, documents, audit trail|Urgent questions, quick yes/no |
| Messenger|Quick coordination, clarifications, informal updates|Long discussions, signature approvals |
| Call|Urgent blockers, emotional topics, complex negotiations|Things needing written record (follow up with email) |
| Meeting|Brainstorming, alignment 3+ stakeholders|Status updates (email), decisions one person can make |

---

## C. Tone Management

### Respectful Without Being Servile

| servile|respectful |
|---|---|
| Не сочтите за дерзость, но мне кажется, возможно, стоило бы...|Предлагаю другой вариант: ... |
| Простите, что отнимаю ваше драгоценное время...|Есть вопрос по срокам -- займёт пару минут. |
| Осмелюсь предположить...|Думаю, причина в ... |
| Если вас не затруднит и будет удобно...|Пришлите, пожалуйста, отчёт до пятницы. |

### Direct Without Being Rude

| rude|direct |
|---|---|
| Вы опять не сделали отчёт.|Отчёт не получен. Пришлите до 17:00, пожалуйста. |
| Я же говорил.|Обсуждали 10 марта (ссылка). Давайте вернёмся к тому решению. |
| Это не моя проблема.|Вопрос в зоне логистики. Подключаю Олега. |
| Разберитесь уже наконец.|Предлагаю разобрать на звонке сегодня в 15:00. |

### «Вы» vs «ты»

| Context|Norm |
|---|---|
| First contact, unknown person|Always «вы» |
| Formal correspondence (clients, partners, officials)|Always «вы» |
| Internal team IT/startup|Often «ты» by convention -- follow team norms |
| Other person switched to «ты»|May reciprocate, no obligation |
| Mass emails, mixed audience|Always «вы» |
| When in doubt|«Вы» -- never offends |

5. Capitalized «Вы» = additional formality (official letters, senior officials). Lowercase «вы» = normal business email.

### Softening Without Weakening

| hard|soft |
|---|---|
| Вам необходимо прислать отчёт.|Пришлите, пожалуйста, отчёт до пятницы. |
| Вы должны это исправить.|Предлагаю исправить до релиза -- вот что нужно: ... |
| Я требую объяснений.|Расскажите, пожалуйста, что произошло -- хочу разобраться. |
| Немедленно перезвоните.|Позвоните, когда будет возможность -- вопрос срочный. |
| Это нужно переделать.|Есть несколько правок. Основное: [конкретика]. |

---

## D. Clean Business Phrases

Replace bureaucratic filler with clear, human language.

| bureaucratic|clean|cat |
|---|---|---|
| Довожу до вашего сведения|Сообщаю / Рассказываю|opening |
| Настоящим уведомляем|Сообщаем|opening |
| Данным письмом информируем|Пишу, чтобы рассказать|opening |
| В рамках настоящего письма|В этом письме|opening |
| Обращаюсь к вам с просьбой|Прошу|opening |
| Хотелось бы поставить вас в известность|Хочу рассказать|opening |
| По существу вопроса сообщаю следующее|Отвечаю на ваш вопрос|opening |
| В связи с вышеизложенным|Поэтому|transition |
| На основании вышесказанного|Итого|transition |
| Принимая во внимание тот факт, что|Учитывая, что / Так как|transition |
| Исходя из имеющейся информации|По нашим данным|transition |
| В целях обеспечения|Чтобы|transition |
| В соответствии с достигнутыми договорённостями|Как мы договорились|transition |
| Ввиду сложившихся обстоятельств|Из-за (конкретная причина)|transition |
| В случае возникновения вопросов|Если есть вопросы|transition |
| Просим вас рассмотреть возможность|Предлагаем|request |
| Убедительно просим вас|Пожалуйста / Прошу|request |
| Прошу вас обеспечить выполнение|Пожалуйста, сделайте|request |
| Ожидаем вашего содействия|Нужна ваша помощь|request |
| Просим произвести оплату|Пожалуйста, оплатите|request |
| Необходимо осуществить|Нужно сделать|request |
| Просим подтвердить получение настоящего письма|Подтвердите, что получили|request |
| Просим предоставить информацию|Расскажите / Пришлите данные|request |
| Считаем необходимым отметить|Обращаю внимание|emphasis |
| Не представляется возможным|Не получится / Невозможно|refusal |
| Вынуждены отказать|Не сможем|refusal |
| Не имеем возможности|Не можем|refusal |
| К сожалению, вынуждены констатировать|К сожалению,|refusal |
| Данный вопрос находится на рассмотрении|Решение ещё не принято / Думаем|status |
| Работа ведётся в штатном режиме|Всё идёт по плану|status |
| На данный момент времени|Сейчас|time |
| В ближайшее время|До [конкретная дата]|time |
| В кратчайшие сроки|До [дата] / Завтра / К пятнице|time |
| По истечении установленного срока|После дедлайна / После [дата]|time |
| Вышеупомянутый / нижеперечисленный|Этот / Вот они|reference |
| Вышеуказанные рекомендации|Эти рекомендации|reference |
| С уважением и надеждой на дальнейшее плодотворное сотрудничество|С уважением, [имя]|closing |
| Заранее благодарим за оперативный ответ|Буду благодарен за ответ до [дата]|closing |
| Надеемся на положительное решение вопроса|Надеемся, что получится|closing |
| Остаёмся в ожидании вашего ответа|Жду ответа до [дата]|closing |
| Выражаем надежду на взаимовыгодное сотрудничество|Будем рады работать вместе|closing |

---

## E. Meeting Notes Structure

### Template

```
# Meeting: [Topic]
Date: [date], [time]
Participants: [names]

## Decisions
1. [Decision] -- rationale if not obvious

## Action Items
| # | Task | Owner | Deadline |
|---|------|-------|---------|
| 1 | [Task] | [Name] | [Date] |

## Open Questions
- [Question] -- who investigates, by when

## Next Meeting
[Date, time, agenda if known]
```

### Rules
1. Decisions as statements, not discussion summaries. "Decided to postpone to April 5" -- not "We discussed and considered options..."
2. Every action item: exactly one owner + one deadline. "The team" is not an owner.
3. No decision? Write: "No decision. [Name] will prepare data by [date]."

---

## F. Saying No Respectfully

Structure: **acknowledge -- decide -- offer alternative**.

1. **Acknowledge** the request (show you understood).
2. **State decision** clearly and early (don't bury "no" in paragraph 3).
3. **Brief reason** (one sentence, not a defensive essay).
4. **Alternative** if possible.
5. **Constructive ending.**

### Best Examples

**Declining a meeting:**
> Не смогу быть 15 марта -- финализирую отчёт. Готов ответить письменно заранее. Пришлите повестку?

**Rejecting a proposal:**
> Спасибо за предложение. Не подходит по бюджету -- лимит распределён. Вернёмся в июне при планировании Q3.

**Denying a deadline extension:**
> Понимаю, задача сложнее. Перенести дедлайн не получится -- зависит запуск. Давайте упростим скоуп.

---

## Sources
See [sources.md](sources.md)


path: references/editorial-grammar.md
content: # Editorial: Grammar and Style

## Contents
- [C. Capitalization](#c-capitalization)
- [D. Agreement (syntactic concord)](#d-agreement-syntactic-concord)
- [E. Tautology and pleonasms](#e-tautology-and-pleonasms)
- [F. List homogeneity](#f-list-homogeneity)
- [G. Numbers in text](#g-numbers-in-text)
- [H. Clean language principles (inspired by the anti-bureaucratic tradition, cf. N. Gal)](#h-clean-language-principles-inspired-by-the-anti-bureaucratic-tradition-cf-n-gal)
- [Sources](#sources)

## C. Capitalization

### C.1. After colon

situation|upper/lower|example
enumeration after generalizing word|lower|Привезли: молоток, пилу, рубанок.
direct speech|upper|Он ответил: "Согласен".
two independent sentences (journalistic)|upper allowed|Итог очевиден: Команда проиграла.
list item after digit with period (1.)|upper|1. Подготовить документы.
list item after digit/letter with bracket (1), а))|lower|а) подготовить документы;

### C.2. Headings

Russian does NOT use Title Case. Only first word and proper nouns are capitalized.
- Correct: "Краткий курс теоретической механики"
- Wrong: "Краткий Курс Теоретической Механики"

### C.3. Job titles and ranks

context|upper/lower|example
running text (general use)|lower|президент компании, генеральный директор
official document (decree, order)|upper|Президент Российской Федерации
supreme state positions in official docs|upper|Председатель Правительства
academic degrees, titles|always lower|доктор наук, профессор, академик

### C.4. Geographic names

1. All words in official name capitalized: Великий Новгород, Нижний Тагил
2. Generic term lowercase unless part of name: город Москва, озеро Байкал; but: Белое море
3. Foreign function words (articles, prepositions) lowercase: Рио-де-Жанейро, Франкфурт-на-Майне

### C.5. After ellipsis

situation|upper/lower
ellipsis ends sentence|upper (new sentence): Всё кончилось... Наступила тишина.
ellipsis = pause inside sentence|lower: Он вошёл... и остановился.
ellipsis at text start (continuation)|lower: ...и тогда всё стало ясно.

### C.6. Quotation marks and names

1. First word inside quotation marks capitalized: роман "Война и мир"
2. Other words follow general rules (lowercase unless proper noun)
3. Organizations: ООО "Ромашка", ПАО "Газпром"

---

## D. Agreement (syntactic concord)

### D.1. Collective nouns as subject

Words ряд, большинство, меньшинство, часть, множество, несколько allow singular or plural predicate.

Singular predicate (grammatical agreement):

condition|example
no dependent word|Большинство согласилось.
dependent word in singular|Ряд предложений был отклонён.
subject = inanimate|Большинство зданий было построено.
predicate = passive participle|Часть документов была утрачена.
predicate before subject|Пришло несколько человек.

Plural predicate (semantic agreement):

condition|example
animate subject, separate actions emphasized|Большинство студентов сдали экзамен.
distance between subject and predicate|Ряд сотрудников, работающих в отделе, подали заявления.
homogeneous predicates|Большинство вышли и присоединились.
participial phrase / subordinate in plural|Часть студентов, которые не сдали, были отчислены.
enumeration at subject|Большинство -- инженеры, врачи, учителя -- проголосовали.

### D.2. Numerals + noun

numeral|noun case|example
1 (21, 31, 101...)|nom. sg.|двадцать один студент
2, 3, 4 (22, 33, 44...)|gen. sg.|двадцать два студента
5-20, 25-30 etc.|gen. pl.|пять студентов
fractions|gen. sg.|две трети территории
полтора/полторы|gen. sg.|полтора часа, полторы минуты

Predicate number with numeral subject:
- Singular: inanimate, emphasis on totality. Прошло пять лет.
- Plural: animate, separate actions. Пять студентов сдали экзамен.

### D.3. Compound subjects

connector|rule|example
и (both animate)|plural|Мать и дочь пришли.
или / либо|by nearest subject|Поездка или путешествие состоится.
ни... ни|plural (usually)|Ни дождь, ни ветер не помешали.
не только... но и|by nearest to predicate|Не только студенты, но и преподаватель присутствовал.
как..., так и|plural|Как дети, так и взрослые участвовали.

### D.4. Mixed gender

Subjects of different gender joined by "и" -> plural predicate: Стол и лампа стояли.
With inversion, singular by nearest is allowed: У окна стояла лампа и стол.

---

## E. Tautology and pleonasms

Pleonasm: words duplicating each other's meaning. Tautology: adjacent cognate words.

### E.1. Pleonasms

wrong|correct|why
свободная вакансия|вакансия|вакансия = free position
прейскурант цен|прейскурант|прейскурант = price list
памятный сувенир|сувенир|сувенир = keepsake
совместное сотрудничество|сотрудничество|со- = together
полный аншлаг|аншлаг|аншлаг = sold out
временная отсрочка|отсрочка|отсрочка = time delay
ведущий лидер|лидер|лидер = leader
впервые познакомиться|познакомиться|always first time
главный приоритет|приоритет|приоритет = top thing
демобилизоваться из армии|демобилизоваться|only army
жестикулировать руками|жестикулировать|hands by definition
импортировать из-за рубежа|импортировать|импорт = from abroad
коллега по работе|коллега|коллега = workmate
народный фольклор|фольклор|фольклор = folk art
перспективы на будущее|перспективы|перспектива = future view
подняться вверх|подняться|подняться = go up
предварительное планирование|планирование|always preliminary
самый оптимальный|оптимальный|superlative built-in
автобиография жизни|автобиография|авто+био = own life
взаимное сотрудничество|сотрудничество|со- = mutually
возвратиться обратно|возвратиться|воз- = back
главная суть|суть|суть = the main point
депиляция волос|депиляция|депиляция = hair removal
другая альтернатива|альтернатива|альтернатива = other option
дублировать дважды|дублировать|дубль = double
единогласный консенсус|консенсус|консенсус = full accord
заранее предупредить|предупредить|пред- = beforehand
каждая деталь важна и существенна|каждая деталь важна|synonyms
краткое резюме|резюме|резюме = brief summary
лично я|я|я = always personal
местный абориген|абориген|абориген = local
молодой юноша|юноша|юноша = young man
наиболее оптимальный|оптимальный|superlative built-in
начальные азы|азы|азы = the very basics
неожиданный сюрприз|сюрприз|сюрприз = surprise
ностальгия по родине|ностальгия|ностальгия = homesickness
огромная махина|махина|махина = huge thing
первый дебют|дебют|дебют = first show
передовой авангард|авангард|авангард = vanguard
период времени|период|период = time span
полное фиаско|фиаско|фиаско = total failure
предварительный анонс|анонс|анонс = advance notice
прогнозировать на будущее|прогнозировать|forecast = future
саммит на высшем уровне|саммит|саммит = top-level meeting
своя автобиография|автобиография|авто- = own
смешивать вместе|смешивать|mixing = combining
спуститься вниз|спуститься|спуститься = go down
страсть к графомании|графомания|мания = obsession
хронометраж времени|хронометраж|хроно- = time
экспонат выставки|экспонат|экспонат = exhibited item

### E.2. Tautology (cognate repeats)

wrong|correct
спросить вопрос|задать вопрос
организовать организацию|создать организацию
следует учитывать следующие факторы|нужно учитывать такие факторы
проливной ливень|сильный ливень / проливной дождь
сгруппировать в группы|объединить в группы
проектировать проект|разрабатывать проект
адресовать адресату|направить адресату

---

## F. List homogeneity

### F.1. Grammatical parallelism

All list items must agree with the introductory phrase and share the same grammatical form.
Do not mix: verbal nouns, infinitives, plain nouns in one list.

### F.2. Level-of-detail homogeneity

Items must be at the same level of abstraction. Do not mix: Python, JavaScript, "databases", VS Code.

### F.3. Do not mix questions and statements

All items in one modality: all statements or all questions.

### F.4. List punctuation

start|case|ending|example
after digit with period (1.)|upper|period|1. Подготовить документацию.
after digit/letter with bracket 1) а)|lower|semicolon (last = period)|1) подготовить документацию;
after bullet/dash|lower|semicolon (last = period)|-- подготовить документацию;
item = full sentence|upper|period|-- Необходимо подготовить документацию.

Period rule: period only if item is a full sentence (has subject and predicate). Fragments end with semicolon, last with period.

---

## G. Numbers in text

### G.1. Words vs digits

situation|format|example
1-9 in narrative text|words|Прошло три дня.
10+|digits|Участвовало 15 человек.
at sentence start|always words|Двадцать пять заявок поступило.
adjacent numbers|one words, one digits|три 10-литровых канистры
large round numbers|mixed|1,5 млн, 20 тыс.
tables, formulas, statistics|digits|5, 12, 230
monetary amounts in documents|digits + words in parens|150 000 (сто пятьдесят тысяч) руб.

### G.2. Ordinal numerals

Suffix via hyphen (not period):

correct|wrong
1-й этаж|1. этаж, 1ый этаж
2-я попытка|2ая, 2-ая
3-е место|3ье, 3е
5-го числа|5ого

Suffix rule: if letter before last ending letter is vowel -- one-letter suffix (1-й, 2-я, 3-е, 5-м). If consonant -- two letters (2-го, 5-му).

When listing ordinals, suffix only on last: 1, 2 и 3-й этажи (not 1-й, 2-й и 3-й).

### G.3. Dates and time

context|format|example
in text|day digit, month word, year digit|15 марта 2026 года
in tables/forms|numeric|15.03.2026
decades|with suffix|90-е годы (not 90-ые)
centuries|Roman|XX век, XXI века
time|colon|14:30, 09:00
date range|dash no spaces|2020--2025, январь--март
year range with г./гг.|with period|2020--2025 гг., в 2024 г.

### G.4. Phone numbers

Standard format: +7 (999) 123-45-67
1. Country code separated by space
2. City/operator code in parentheses
3. Number split by hyphens: 3+2+2 digits (7-digit) or 2+2+2 (6-digit)

### G.5. Uniformity rule

Do not mix words and digits for same-type values within one sentence/paragraph.
- Wrong: три менеджера, 5 инженеров и семь техников
- Right: 3 менеджера, 5 инженеров и 7 техников

---

## H. Clean language principles (inspired by the anti-bureaucratic tradition, cf. N. Gal)

### H.1. Officialese (канцелярит) -- disease markers

1. Verbal nouns instead of verbs: "приняли решение" -> "решили"; "оказали помощь" -> "помогли"
2. Genitive chains: "план мероприятий по обеспечению выполнения решений" -- unreadable
3. Passive voice instead of active: "Доклад был заслушан" -> "Мы выслушали доклад"
4. Split predicates: "произвести уборку" -> "убрать"; "осуществить проверку" -> "проверить"
5. Stacked participial/gerundial phrases make sentence impassable

### H.2. Dead constructions -> live replacements

dead|live
произвести ремонт|отремонтировать
осуществить доставку|доставить
оказать содействие|помочь
принять решение|решить
провести мероприятие|организовать / устроить
поставить в известность|сообщить / предупредить
иметь место|случиться / произойти
в данный момент времени|сейчас
на сегодняшний день|сегодня
в целях обеспечения|чтобы
в адрес (кого-либо)|кому-либо
является одним из...|один из...
представляется возможным|можно
в настоящее время|сейчас / теперь
в случае если|если
в связи с тем что|потому что / так как
вышеуказанный|этот / упомянутый
нижеследующий|следующий / такой
надлежащий|нужный / подходящий

### H.3. Translation traps leaking into Russian

1. English passive -> Russian passive: "Было обнаружено, что..." -> "Выяснилось, что..." / "Мы обнаружили, что..."
2. Noun-heavy English -> genitive chains: "Процесс принятия решения" -> "Как мы решаем"
3. Redundant possessives: "Он положил свою руку в свой карман" -> "Он положил руку в карман"
4. Calques: "Имеет смысл", "играет роль" -- acceptable but often displace better Russian alternatives

### H.4. How officialese spreads

1. Media retelling official documents transfers their style to articles
2. Corporate correspondence infects work and personal writing
3. Bureaucratic replies teach people to write the same way
4. Desire to sound "weightier" -- long unclear phrase seems more "solid" than a simple word

### H.5. Clean text rules

1. Verb over noun: replace verbal nouns with verbs wherever possible
2. Short sentence over long: if it does not fit in one breath -- too long
3. Check genitive chains: more than two genitives in a row -- rewrite
4. Active voice by default: passive only when agent is unknown or irrelevant
5. Concrete over abstract: "в рамках мероприятия" -> "на встрече"; "в сфере образования" -> "в школах"
6. Use simple words: "сделать" not "реализовать"; "начать" not "приступить к осуществлению"
7. Read aloud: if you stumble -- rewrite the sentence

## Sources
See [sources.md](sources.md)


path: references/editorial-punctuation.md
content: # Editorial: Punctuation

## Contents
- [A. Punctuation in complex sentences](#a-punctuation-in-complex-sentences)
- [B. Comma traps -- reference table](#b-comma-traps----reference-table)
- [Sources](#sources)

## A. Punctuation in complex sentences

### A.1. Comma before subordinating conjunctions

Subordinate clause is separated by comma. Conjunctions: **что, который, где, когда, если, чтобы, потому что, так как** mark the boundary.

Base rule: comma before the conjunction starting the subordinate clause.

When comma before "что" is NOT needed:

construction|comma?|rule
compound conjunction stays whole|no|"потому что" is one unit; comma before "потому", not "что"
negation + что|no|fixed expression: "не то что обидно"
semantically whole phrase|no|"делай что хочешь" -- indivisible
что = interrogative pronoun|no|"что случилось?" -- not a conjunction
two conjunctions without "то"|no|no comma between "что" and "если" when "то" follows
parallel subordinates with "и"|no|"я знаю, что он придёт и что поможет" -- no comma before second "что"

Compound conjunctions -- where to place the comma:

Compound subordinating conjunctions can be split: comma moves from start of subordinate to first part of conjunction when author emphasizes reason/condition.

- Neutral: comma before whole conjunction ("потому что", "для того чтобы")
- Emphatic: comma after first part ("потому, что"; "для того, чтобы")
- Same pattern: несмотря на то(,) что; в связи с тем(,) что; ввиду того(,) что; благодаря тому(,) что

### A.2. Dash between subject and predicate

Dash is placed when subject and predicate are the same part of speech without a linking verb.

subject|predicate|dash?
noun (nom.)|noun (nom.)|yes: Москва -- столица России
infinitive|infinitive|yes: Жить -- Родине служить
noun (nom.)|infinitive|yes: Наша задача -- закончить проект
infinitive|noun (nom.)|yes: Читать -- большое удовольствие
numeral|numeral|yes: Дважды два -- четыре
noun (nom.)|это/вот/значит + noun|yes: Язык -- это инструмент мышления

Dash is NOT placed:

1. "не" before predicate: Бедность не порок
2. Subject is personal pronoun: Он врач (but: Он -- это тот, кто поможет)
3. Parenthetical/adverb/conjunction/particle between: Собака тоже друг; Вода словно зеркало
4. Predicate before subject (inversion): Замечательный человек ваш отец
5. как/будто/словно between: Глаза как звёзды

### A.3. Colon

1. Generalizing word before enumeration: На столе: договор, акт, счёт-фактура
2. Asyndetic compound -- cause (= потому что): Я не пошёл: поднялась температура
3. Asyndetic -- clarification (= а именно): Погода была ужасная: дул ветер, шёл дождь
4. Asyndetic -- supplement (= что): Я чувствовал: что-то изменилось
5. Direct speech after author's words: Он сказал: "Я уже здесь"

### A.4. Semicolon

1. Extended parallel members with internal commas
2. Significantly extended parts of asyndetic compound sentence
3. Lowercase list items (see section F in editorial-grammar)

### A.5. Introductory words punctuation

Introductory words/phrases: commas on both sides (mid-sentence) or one comma (start/end).

NOT introductory (no commas): ведь, вот, всё-таки, даже, именно, как будто, как бы, между тем (= тем временем), поэтому, примерно, притом, причём, якобы.

---

## B. Comma traps -- reference table

Mnemonic: if the word can be removed without losing meaning or grammar -- it is introductory, comma needed. If it cannot -- it is a sentence member, no comma.

construction|comma?|rule
как будто|no|particle-conjunction, not introductory
как правило|yes, both sides|introductory (indicates normality)
в том числе|comma before|appositional, clarification
кроме того|yes, after (start); both sides (mid)|introductory
тем не менее|yes, both sides (usually)|concessive introductory; at start -- comma after
однако (start)|no after|adversative conjunction (= но)
однако (mid/end)|yes, both sides|introductory word
наконец (итог перечисления)|yes|introductory: во-первых... наконец
наконец (= наконец-то)|no|adverb, time circumstance
значит (= следовательно)|yes, both sides|introductory
значит (= означает)|no|predicate: Жить -- значит бороться
таким образом (= итак)|yes|introductory, summing up
таким образом (= таким способом)|no|manner adverbial
во-первых, во-вторых|yes, after|introductory, argument order
может быть / может|yes|introductory, assumption
конечно|yes|introductory, certainty
конечно (= безусловно, да)|no (in reply)|affirmative particle
кстати|yes|introductory, incidental remark
кстати (= к месту)|no|adverb: Замечание пришлось кстати
правда (= действительно)|yes|introductory
правда (= но, хотя)|no (comma before as before conjunction)|conjunction-caveat
видимо|yes|introductory, assumption
казалось бы|yes, both sides|introductory
между прочим|yes|introductory, incidental remark
например|yes|introductory; colon after if enumeration follows
по-моему, по-твоему|yes|introductory, opinion marker
действительно (start = да)|yes|introductory, confirmation
действительно (= на самом деле, mid)|no|adverb-circumstance
в частности|yes|introductory, specification
с одной стороны... с другой стороны|yes, each part|introductory, paired construction
прежде всего (= во-первых)|yes|introductory
прежде всего (= в первую очередь)|no|circumstance
в свою очередь (= между тем)|yes|introductory (in journalism)
в свою очередь (= ответно)|no|circumstance
к сожалению|yes|introductory, emotional evaluation
к счастью|yes|introductory, emotional evaluation
по крайней мере|yes (usually)|introductory, limitation
впрочем|yes, after (start); both sides (mid)|introductory, caveat
итак|yes, after|introductory, conclusion
следовательно|yes|introductory, conclusion
безусловно|yes|introductory, certainty
несомненно|yes|introductory, certainty
допустим|yes|introductory, assumption
предположим|yes|introductory, assumption
как бы|no|particle
причём|no (comma before, not after)|appositional conjunction
притом|no|appositional conjunction
поэтому|no|adverb-conjunction
буквально|no|adverb
якобы|no|particle
даже|no|particle
всё-таки|no|particle
вдруг|no|adverb
авось|no|particle
вряд ли|no|particle
исключительно|no|adverb

## Sources
See [sources.md](sources.md)


path: references/info-style.md
content: # Информационный стиль: методология ясного текста

Справочник по информационному стилю для русского текста.
Independent reference informed by: glvrd.ru, bureau.ru, maximilyahov.ru, leading newsroom editorial practices, Habr.
Все формулировки авторские; книги и авторы -- источники идей, а не цитат.

## Contents
- [A. Философия](#a-философия)
- [B. Каталог стоп-слов](#b-каталог-стоп-слов)
- [C. Усиление слабого текста](#c-усиление-слабого-текста)
- [D. Структура текста](#d-структура-текста)
- [E. Числа и факты](#e-числа-и-факты)
- [F. Адаптация регистра](#f-адаптация-регистра)
- [G. Newsroom editorial workflow principles](#g-newsroom-editorial-workflow-principles)
- [Sources](#sources)

## A. Философия

Базовые принципы, определяющие подход к тексту.

1. Текст для читателя, не для автора. Автор решает задачу: передать знание, помочь решить, сэкономить время. Предложение без пользы для читателя -- лишнее.
2. Каждое предложение отрабатывает место. Нет балласта. Слово без смысловой нагрузки -- убрать. Сокращение -- забота о читателе, не примитивизация.
3. Уважение к времени. Не лить воду, не повторяться, не заставлять продираться через мусор. Краткость -- форма уважения.
4. Факты вместо мнений, конкретика вместо обобщений. Опора на проверяемые факты, числа, примеры. Оценки без доказательств ничего не значат. Читатель сам делает выводы.
5. Полезное действие. У текста -- конкретный результат для читателя. Сформулировать до написания: что читатель сможет сделать/узнать/решить. Нет полезного действия -- текст не нужен.
6. Истории и примеры вместо деклараций. Абстракции не убеждают, конкретные сценарии -- убеждают. Текст создаёт картинку. Нет картинки после абзаца -- абзац слабый.
7. Честность и прозрачность. Нет манипуляций, недомолвок, скрытой рекламы. Рекламный текст -- явно рекламный. Не знаешь -- скажи прямо.

## B. Каталог стоп-слов

Слова, удаляемые без потери смысла. Категории постоянны, конкретный список -- нет.

### Канцелярит (bureaucratic)
слово|замена
является|тире / перестроить
осуществлять|делать, проводить, вести
в настоящее время|сейчас
на сегодняшний день|сейчас, сегодня
данный|этот, тот
вышеуказанный|этот; убрать если понятно
нижеследующий|убрать; перестроить
в связи с тем, что|потому что, так как
ввиду|из-за, потому что
в целях|чтобы, для
в соответствии с|по, согласно
надлежащий|нужный, правильный
производить (работы)|делать, работать
функционировать|работать
задействовать|использовать
обеспечить|указать конкретное действие
имеет место быть|есть, происходит
принять решение|решить
оказывать содействие|помочь
произвести оплату|оплатить, заплатить

### Вода (filler)
слово|замена
определённый|указать что именно
соответствующий|назвать конкретно
некоторый|указать количество или убрать
достаточно|убрать или указать меру
в целом|убрать; оговорку сделать конкретной
как бы|убрать
собственно говоря|убрать
так сказать|убрать
кстати|убрать или встроить в структуру
между прочим|убрать или перестроить
что касается|начать сразу с темы
стоит отметить, что|убрать, начать с сути
следует подчеркнуть|убрать, дать факт
нельзя не отметить|убрать
не секрет, что|убрать

### Усилители (amplifiers)
слово|замена
очень|точное слово или факт
крайне|конкретизировать
чрезвычайно|убрать или дать факт
максимально|указать конкретную меру
предельно|указать конкретную меру
абсолютно|убрать или обосновать
невероятно|заменить фактом
буквально|убрать или использовать по назначению
реально|убрать
действительно|убрать; если важно -- доказательство
по-настоящему|убрать

### Оценки без доказательств (unproven claims)
слово|замена
лучший|по какому критерию, по чьим данным
уникальный|описать конкретное отличие
качественный|описать конкретные свойства
эффективный|указать метрику (+40% к конверсии)
инновационный|описать что именно нового
высококлассный|привести факты, сертификаты, рейтинги
оптимальный|назвать критерии
передовой|что впереди и по какому параметру
выгодный|показать числа
надёжный|гарантийный срок, статистика отказов

### Штампы (cliches)
слово|замена
команда профессионалов|квалификации, опыт, число специалистов
молодая динамично развивающаяся компания|факты: год основания, рост
индивидуальный подход|конкретный процесс работы с клиентом
широкий ассортимент|число позиций или категории
выгодные цены|назвать цены или дать сравнение
работы любой сложности|примеры выполненных работ
гибкая система скидок|размер скидок и условия
кратчайшие сроки|конкретный срок
лидер рынка|доля рынка или рейтинг
богатый опыт|количество лет, проектов, клиентов

### Паразиты времени (temporal parasites)
слово|замена
в настоящий момент|сейчас или убрать
на данный момент|сейчас или убрать
в наши дни|убрать; указать год если важно
в современном мире|убрать или назвать контекст
на протяжении долгих лет|указать количество лет
испокон веков|убрать или дать дату
в скором времени|указать срок
в ближайшем будущем|назвать дату или месяц

### Вводные конструкции и междометия
слово|замена
конечно|убрать
разумеется|убрать
безусловно|убрать или обосновать
впрочем|перестроить логику абзаца
тем не менее|убрать или заменить на «но»
допустим|убрать или сформулировать условие явно
скажем|убрать
ну|убрать
ах, ох, ух|убрать

### Неопределённость и модальность
слово|замена
какой-то|указать конкретно
что-то|назвать
где-то|указать место или число
как-то|убрать или уточнить
можно|убрать: вместо «можно сделать» -- «сделайте»
нужно / необходимо|переформулировать: кому нужно? зачем?
следует|указать кто и почему
мне бы хотелось|написать прямо: «я хочу», «я предлагаю»
было бы неплохо|сформулировать прямо

## C. Усиление слабого текста

Три признака слабого текста: (1) можно убрать слова без потери смысла, (2) нет конкретики, (3) нет картинки в голове читателя. Три шага усиления: убрать мусор, добавить факты, перестроить структуру.

### Примеры трансформации

1. Удаление воды
До: «Наша компания на протяжении долгих лет осуществляет деятельность в сфере предоставления консалтинговых услуг, являясь одним из лидеров рынка.»
После: «Мы консультируем бизнес 12 лет. Среди клиентов -- 40 компаний из списка РБК-500.»

2. Оценка -> факт
До: «Мы предлагаем качественную продукцию по выгодным ценам с быстрой доставкой.»
После: «Доставляем мебель из массива берёзы от 15 000 руб. за 2 рабочих дня. Гарантия -- 5 лет.»

3. Пассив -> актив
До: «Решение о выдаче кредита принимается банком в течение определённого периода времени после подачи заявки.»
После: «Банк решает по кредиту за 2 часа после заявки.»

4. Абстракция -> сценарий
До: «Наш сервис обеспечивает максимально эффективную оптимизацию бизнес-процессов.»
После: «Бухгалтер тратил 3 дня на закрытие месяца. После внедрения -- 4 часа. Высвободившееся время ушло на аналитику.»

5. Штамп -> конкретика
До: «Команда высококлассных профессионалов с богатым опытом работы решит задачи любой сложности.»
После: «В команде 8 инженеров, у каждого 5--15 лет в проектировании мостов. Последний проект -- мост через Обь длиной 960 м.»

6. Перегруженное предложение -> несколько простых
До: «В ходе проведения мероприятия, направленного на повышение квалификации сотрудников, которое было организовано отделом кадров при содействии внешних консультантов, был отмечен значительный рост вовлечённости участников.»
После: «Отдел кадров провёл тренинг с внешними консультантами. Вовлечённость выросла: 90% выполнили все задания, в прошлом году -- 60%.»

7. Запугивание -> польза
До: «Если вы не начнёте заботиться о своём здоровье прямо сейчас, последствия могут быть крайне печальными и необратимыми.»
После: «30 минут ходьбы в день снижают риск инфаркта на 35% (данные ВОЗ, 2023).»

8. Навязывание оценки -> доказательство
До: «Наш удивительный продукт поразит вас невероятным удобством и поможет вам по-настоящему улучшить вашу жизнь.»
После: «Настройка -- 3 минуты. Через неделю пользователи экономят 40 мин/день на рутине (опрос 1200 клиентов).»

9. Длинный вводный абзац -> прямой заход
До: «В современном мире, где технологии развиваются с невероятной скоростью, а конкуренция растёт с каждым днём, всё больше компаний задумываются о том, как автоматизировать свои процессы.»
После: «Автоматизация рутины сокращает расходы на 20--40%. Вот как это работает.»

10. Самовосхваление -> факты
До: «Мы очень гордимся тем, что являемся одной из лучших компаний в своей отрасли и предоставляем услуги безупречного качества.»
После: «Рейтинг 4.9/5 на основе 3 400 отзывов. За год ни одной претензии по срокам доставки.»

11. Условные обороты -> прямое руководство
До: «Было бы неплохо, если бы вы могли уделить некоторое время тому, чтобы ознакомиться с нашим новым каталогом.»
После: «Посмотрите каталог -- там 120 новых позиций.»

## D. Структура текста

Правила организации текста для максимальной читаемости.

1. Главная мысль -- в начале текста и в начале каждого раздела.
2. Детали, доказательства, контекст -- ниже главной мысли.
3. Читатель, бросивший текст на любом абзаце, уносит главное.
4. Лид -- один абзац с ключевым фактом или выводом.
5. Тело -- подробности, доказательства, цитаты, числа.
6. Хвост -- дополнительный контекст, который не жалко потерять.
7. Формула 5W для новостей/справок: кто, что, где, когда, почему -- все ответы в лиде.
8. Первое предложение абзаца = его тезис.
9. Читатель пробегает первые строки абзацев -- понимает структуру всего текста.
10. Первое предложение не сообщает тему абзаца -- абзац плохо структурирован.
11. Пример. Слабо: «В последнее время многие компании столкнулись с различными проблемами. Одна из них -- рост стоимости аренды.» Сильно: «Аренда офисов в Москве выросла на 20% за год. Это вынуждает переходить на удалёнку.»
12. Один абзац -- одна мысль.
13. Оптимальный размер абзаца: 3--5 предложений.
14. Абзац длиннее -- скорее всего, смешаны две мысли; разбить.
15. Переход причинно-следственный: «поэтому», «из-за этого».
16. Переход контрастный: «но», «однако».
17. Переход дополняющий: «кроме того», «ещё один фактор».
18. Переход хронологический: «после этого», «затем».
19. Переход не формулируется естественно -- сменить порядок абзацев.
20. Читатель в любой момент понимает, о чём этот текст.
21. Читатель в любой момент понимает, зачем он это читает.
22. Читатель в любой момент понимает, что будет дальше.
23. Заголовок сообщает тему и пользу, а не интригует.
24. Подзаголовки работают как оглавление: прочесть отдельно = получить скелет текста.
25. Списки используются для перечислений из 3+ однородных пунктов.
26. Лид сразу говорит, что получит читатель.
27. Заголовки содержат конкретику; заголовки -- информация, не декорация.
28. Подзаголовок и начало абзаца после него совпадают по теме.
29. Пример. Слабый заголовок: «Преимущества». Сильный: «Экономия 40% на отоплении за счёт утепления стен».
30. Пример. Слабый заголовок: «Немного о нас». Сильный: «12 лет строим мосты в Сибири».
31. Тест заголовка: если подходит к любому тексту на похожую тему -- он плохой. Хороший подходит только к этому тексту.

## E. Числа и факты

Правила работы со статистикой, сравнениями и доказательствами.

1. Круглые числа вызывают подозрение. «+100%» -- не верится. «+97%» -- верится.
2. Большие числа нуждаются в масштабе. «2 ТБ» -> «2 ТБ = 500 000 фото или 400 фильмов в HD».
3. Источник обязателен. Число без источника -- мнение.
4. Указывать: кто исследовал, когда, на какой выборке.
5. Не только абсолютное, но и относительное. «Рост на 2 млн руб.» -- ни о чём. «С 8 до 10 млн, +25%» -- понятно.
6. Сравнение с привычным. «Экран 12.9" -- чуть больше листа A4». Незнакомую метрику переводить в повседневный опыт.
7. Временные сравнения. «Было 3 дня, стало 4 часа» -- масштаб улучшения очевиден.
8. Не выдёргивать числа из контекста.
9. Не сравнивать несравнимое (разные периоды, выборки).
10. Не использовать среднее там, где нужна медиана.
11. Не прятать негативные данные; честность укрепляет доверие.
12. Абсолютные числа рядом с процентами. «Рост на 200% с 1 до 3 клиентов» -- уже не впечатляет.
13. Тест утверждения: «Как это проверить?» Нет ответа -- подкрепить или убрать.
14. Иерархия доказательств, уровень 1 (сильнейший): независимое исследование с методологией.
15. Иерархия доказательств, уровень 2: публичная статистика (госорганы, отраслевые ассоциации).
16. Иерархия доказательств, уровень 3: внутренние данные компании (период + выборка).
17. Иерархия доказательств, уровень 4: экспертная оценка с указанием квалификации.
18. Иерархия доказательств, уровень 5 (слабейший): пользовательские отзывы.

## F. Адаптация регистра

Выбор уровня формальности в зависимости от аудитории и канала.

### Шкала регистров
уровень|когда|признаки
Официальный|юрдокументы, госакты|термины, канцелярские обороты оправданы; пассив допустим
Деловой|переписка, отчёты, КП|нейтральная лексика, прямой порядок слов, без сленга и канцелярщины
Профессиональный|статьи для специалистов, техдоки|отраслевые термины без канцелярита; читатель -- коллега
Нейтрально-публицистический|медиа, блоги компаний, объяснительные|простые слова, короткие предложения, примеры из жизни
Разговорный|соцсети, личные блоги, чат поддержки|живая речь, допустим сленг и эмоции контролируемо

6. На любом уровне формальности текст остаётся ясным.
7. Формальность не оправдывает мутность.
8. Даже в юридическом документе стремиться к пониманию с первого прочтения.
9. Определить аудиторию: кто читатель, какой у него контекст.
10. Определить канал: где текст будет опубликован.
11. Определить цель: что должен сделать читатель после прочтения.
12. Выбрать регистр, в котором аудитория привыкла потреблять контент в этом канале.
13. Ошибка: канцелярит в маркетинге. «Компания осуществляет реализацию продукции» в рекламе -- отталкивает.
14. Ошибка: фамильярность в деловой переписке. «Ну чё, давайте созвонимся» -- подрывает доверие.
15. Ошибка: терминология без объяснений для широкой аудитории. «EBITDA выросла на 15%» для клиентов, не знающих термин -- бесполезно.
16. Ошибка: искусственная «живость». Восклицательные знаки и эмодзи не делают текст живым; живым делают детали и истории.

## G. Newsroom editorial workflow principles

Systematic editorial practices pioneered by leading Russian newsrooms, turning info-style theory into a working production system.

1. Автор пишет только о пережитом лично или с доказуемой экспертизой.
2. Рерайт чужих источников и пересказ теории без практики не публикуются.
3. Если автор не пробовал то, о чём пишет, -- статья не выйдет.
4. Каждое утверждение подкреплено конкретным примером, числом или сценарием.
5. Абстрактные советы не допускаются: нужна конкретика -- сколько, как, при каких условиях.
6. Статьи проектируются для переопубликации через месяцы/годы.
7. Привязка к текущим событиям минимальна.
8. 5--6 раундов редактуры на статью.
9. Многоступенчатая редактура: автор -> шеф-редактор раздела -> главный редактор -> выпускающий отдел.
10. Каждый уровень проверяет свой аспект: факты, структуру, стиль, оформление.
11. Условия работы, оплата, требования опубликованы открыто.
12. Автор заранее знает: сколько итераций, какие стандарты, за что платят.
13. «Курс молодого бойца» из 8 частей: цель и тема, фокус, структура, содержание, стиль, исследование, процесс, публикация.
14. Полная редполитика осталась для шеф-редакторов.
15. Рекламный контент маркируется.
16. Партнёрские статьи проходят те же стандарты, но помечаются. Читатель всегда знает, что рекламное.
17. Оплата за результат: гонорар за опубликованную статью, не за время.
18. Отсев на входе: из 4--6 заявок/день одобряются 1--2.
19. Кодификация ошибок: повторяющаяся ошибка -> правило в редполитике.
20. Масштабирование через шефов: система шеф-редакторов по разделам вместо одного главреда.

## Sources
See [sources.md](sources.md)


path: references/scoring.md
content: # Scoring: text quality assessment (0–10)

Analytic rubric for evaluating Russian text quality across 5 dimensions.
Context-aware LLM evaluation based on ~1 040 rules from 16 sources.

## Table of Contents

- [Algorithm overview](#algorithm-overview)
- [Dimensions](#dimensions)
  - [T — Typography](#t--typography-weight-015)
  - [Ч — Clarity](#ч--clarity-weight-025)
  - [Г — Grammar](#г--grammar-weight-020)
  - [С — Structure](#с--structure-weight-020)
  - [Ц — Reader precision](#ц--reader-precision-weight-020)
- [Composite score](#composite-score)
- [Non-compensatory rules](#non-compensatory-rules)
- [Score interpretation](#score-interpretation)
- [Output format](#output-format)
- [Limitations](#limitations)

## Algorithm overview

### Step-by-step procedure

1. **Input.** Russian text of any length.
2. **Domain routing.** Determine text domain (article, UI, business email, general) to load domain-specific rules into the Reader Precision dimension.
3. **Dimension-by-dimension evaluation.** Score each of the 5 dimensions independently using the rubric anchors below. For each dimension, record 1–3 specific issues with the problematic text fragment quoted.
4. **Non-compensatory check.** Apply floor caps if any dimension falls below threshold.
5. **Composite score.** Weighted average of 5 dimensions, rounded to one decimal place.
6. **Diagnostic output.** Total + 5 dimensions + verbal label + specific issues per dimension. Every deducted point is explained.

### Why context-aware evaluation

Formula-based tools (Glavred, Turgenev, Advego) count surface features: stop-words, sentence length, keyword density. Removing «очень» raises the score without improving the text. An SEO text scored 9.1 on Glavred without any real quality.

This rubric evaluates text contextually against 1 040 rules. «Очень» in quoted direct speech is not penalized. «Инновационный» without evidence is penalized. Five orthogonal dimensions cannot be optimized simultaneously without genuinely improving the text.

The only way to raise the score is to write better.

### Research basis

- Readability formulas are unreliable: different formulas diverge by 2–3 grade levels on the same text (Zhou, Jeong, Green 2017). Texts revised for formula scores showed worse reader comprehension (Duffy & Kabance; Olsen & Johnson). 7 reasons to avoid readability formulas (UXmatters 2019).
- LLM-Rubric (ACL 2024): RMSE < 0.5; inter-rater reliability for Structure exceeded human judges (QWK 0.584 vs 0.541).
- Hybrid penalty + bonus + non-compensatory floors: best architecture per analysis of sports judging (gymnastics, figure skating) and academic essay scoring systems.
- Goodhart's Law: «when a measure becomes a target, it ceases to be a good measure.» Five orthogonal dimensions are the primary defense.

---

## Dimensions

### T — Typography (weight 0.15)

Type: hard (objective). Rule source: [typography.md](typography.md) (96 rules).

| Score | Criteria |
|---|---|
| 9–10 | Guillemets for quotes, correct dash types (em/en/hyphen), NBSP after prepositions, special characters (№, ©, °, ×) correct, numbers formatted |
| 7–8 | 1–2 minor issues: missing NBSP, one wrong dash type. Overall picture correct |
| 5–6 | Several systematic errors: mixed dashes and hyphens, some straight quotes |
| 3–4 | Pervasive errors: straight quotes throughout, hyphens instead of dashes, three dots instead of ellipsis glyph |
| 1–2 | No typographic formatting at all: plain ASCII characters |

### Ч — Clarity (weight 0.25)

Type: soft (expert). Rule sources: [info-style.md](info-style.md) (197 rules), [anti-patterns.md](anti-patterns.md) (139 rules).

| Score | Criteria |
|---|---|
| 9–10 | No stop-words, no bureaucratic language, no clichés. Active voice. Every word works. No false intensifiers or unsubstantiated claims |
| 7–8 | 1–3 minor stop-words or passive constructions. Overall tone is clean |
| 5–6 | Noticeable stop-words (5+), several passive constructions, 1–2 clichés. Readable but loose |
| 3–4 | Bureaucratic language dominates: deverbal nouns, genitive chains, split predicates |
| 1–2 | Bureaucratic soup: «осуществление мероприятий по обеспечению надлежащего функционирования» |

### Г — Grammar (weight 0.20)

Type: hard (objective). Rule sources: [editorial-grammar.md](editorial-grammar.md) (171 rules), [editorial-punctuation.md](editorial-punctuation.md) (88 rules).

| Score | Criteria |
|---|---|
| 9–10 | Punctuation flawless, agreement correct, no tautology or pleonasm, capitalization per rules |
| 7–8 | 1–2 minor punctuation errors (missing comma with introductory word). Grammar correct |
| 5–6 | Several punctuation errors, 1–2 agreement errors or tautology |
| 3–4 | Systematic punctuation errors, agreement violations, pleonasms |
| 1–2 | Grammatically illiterate: errors in every sentence |

### С — Structure (weight 0.20)

Type: soft (expert). Rule sources: [info-style.md](info-style.md) (structure section), [addenda.md](addenda.md).

| Score | Criteria |
|---|---|
| 9–10 | Inverted pyramid (main point first). One paragraph = one idea. Logical transitions. Headings where needed. No monotonous dash rhythm |
| 7–8 | Logical structure, but 1–2 overloaded paragraphs or implicit transitions |
| 5–6 | Structure is guessable but ideas are mixed, uneven paragraphs |
| 3–4 | No structure: stream of consciousness without paragraph breaks |
| 1–2 | Chaotic exposition, impossible to identify the main point |

### Ц — Reader precision (weight 0.20)

Type: soft (expert). Rule sources: [info-style.md](info-style.md) (facts/evidence section), domain-specific file when applicable.

Domain routing for this dimension:

| Text type | Additional rules from |
|---|---|
| UI text, buttons, errors, microcopy | [ux-writing.md](ux-writing.md) |
| Email, messenger, business | [business-writing.md](business-writing.md) |
| General / article / documentation | info-style.md only |

| Score | Criteria |
|---|---|
| 9–10 | Concrete facts and numbers. Clear reader benefit. Examples and evidence. No empty declarations. Actionable for the reader |
| 7–8 | Mostly concrete, but 1–2 claims without evidence or abstract phrases |
| 5–6 | Mix of concrete and abstract. Some claims are unsubstantiated. Reader benefit unclear |
| 3–4 | Declarations and promises dominate over facts. Text says nothing |
| 1–2 | Fully abstract: «Мы предлагаем комплексные решения для вашего бизнеса» |

---

## Composite score

```
S = round₁(T × 0.15 + Ч × 0.25 + Г × 0.20 + С × 0.20 + Ц × 0.20)
```

Where `round₁` = round to one decimal place.

Total weight: 0.15 + 0.25 + 0.20 + 0.20 + 0.20 = 1.00.

## Non-compensatory rules

These caps prevent high scores in other dimensions from masking critical weaknesses.

| Condition | Cap | Reason |
|---|---|---|
| Any dimension < 3.0 | Total ≤ 5.0 | Critical weakness is not compensable |
| Typography < 4.0 | Total ≤ 7.0 | Basic typography is mandatory |
| Grammar < 4.0 | Total ≤ 7.0 | Basic grammar is mandatory |

Apply the most restrictive cap when multiple conditions trigger.

## Score interpretation

| Score | Label (RU) | Label (EN) | Meaning |
|---|---|---|---|
| 9.0–10.0 | Эталонный | Benchmark | Ready to publish. Rare result — a reference point, not a target |
| 7.0–8.9 | Хороший | Good | Minor improvements needed. Target range for working texts |
| 5.0–6.9 | Средний | Average | Noticeable issues, editing needed |
| 3.0–4.9 | Слабый | Weak | Significant issues, rewriting needed |
| 0.0–2.9 | Критический | Critical | Full rewrite required |

A score of 8+ is a strong result. 10.0 is a theoretical ideal, not a practical target.

## Output format

```
## Оценка: X.X / 10 — [Label]

| Измерение | Балл | Замечания |
|---|---|---|
| Типографика | X.X | [1–3 specific issues with quoted fragments] |
| Чистота языка | X.X | [1–3 specific issues] |
| Грамотность | X.X | [1–3 specific issues] |
| Структура | X.X | [1–3 specific issues] |
| Точность для читателя | X.X | [1–3 specific issues] |

**Формула:** T×0.15 + Ч×0.25 + Г×0.20 + С×0.20 + Ц×0.20 = X.X
[Non-compensatory cap note, if triggered]

### Что оценка не измеряет
[Limitations list]
```

For texts under 50 words, prepend: «Текст короткий — оценка менее надёжна. Для точной оценки рекомендуется текст от 50 слов.»

## Limitations

The score does NOT measure:

- **Factual accuracy** — numbers and dates may be false but beautifully formatted
- **Audience tone fit** — appropriateness for the specific target audience
- **Creativity and voice** — authorial style and originality
- **Effectiveness** — conversion, engagement, persuasion outcomes
- **Brief compliance** — whether the text meets the client's assignment

These limitations are stated explicitly in every scoring output to prevent overreliance on the score (Goodhart's Law defense).


path: references/sources.md
content: # Sources and Attribution

This plugin would not exist without the extraordinary work of the people listed
below. Their books, articles, and tools have transformed the culture of Russian
text on the internet, raising standards for millions of readers and writers.
Thank you for your dedication and generosity in sharing knowledge.

All formulations in this plugin are the author's own. No content is quoted
verbatim. Listed authors and publishers have not endorsed, reviewed, or
approved this plugin. References are provided for further study and as a
tribute to the works that inspired this project.

## Branch 1 — Typography

1. **Артём Горбунов «Типографика и вёрстка»** (2017) — core typography rules: dashes, quotes, spacing, screen typography — [buy: bureau.ru/projects/book-typography/](https://bureau.ru/projects/book-typography/)
2. **Бюро Горбунова «Советы»** (2005–present, 4809+ tips) — practical micro-advice on typography, editing, design — [bureau.ru/soviet/](https://bureau.ru/soviet/)
3. **А. Э. Мильчин, Л. К. Чельцова «Справочник издателя и автора»** (2021, 6th ed.) — punctuation, abbreviations, number formatting, editorial conventions — [buy: store.artlebedev.com](https://store.artlebedev.com)
4. **Илья Бирман — Типографическая раскладка** (2007–present) — keyboard layout for typing correct typographic characters — [ilyabirman.ru/typography-layout/](https://ilyabirman.ru/typography-layout/)
5. **Type.today — Journal** (2016–present) — Cyrillic typeface design, font pairing, readability — [type.today](https://type.today)

## Branch 2 — Info-Style and Clear Writing

6. **Максим Ильяхов «Пиши, сокращай»** (2017, updated 2025) — foundation of info-style: removing filler, fighting канцелярит, reader-first writing — [buy: book.glvrd.ru](https://book.glvrd.ru)
7. **Максим Ильяхов «Ясно, понятно»** (2019) — advanced info-style: text structure, persuasion, visual-textual integration — [buy: book.glvrd.ru](https://book.glvrd.ru)
8. **Редполитика Т–Ж** (2017–present, 56+ pages) — tone of voice, formatting, numbers, business writing standards — [journal.tinkoff.ru/manual/](https://journal.tinkoff.ru/manual/)
9. **Контур — Гайды** (2020–present) — UX writing for B2B software: interface text, errors, onboarding — [guides.kontur.ru](https://guides.kontur.ru)
10. **Yandex — Gravity UI** (2023–present) — design system with content guidelines for Russian UI text — [gravity-ui.com](https://gravity-ui.com)

## Support — Writing and Language

11. **Максим Ильяхов, Людмила Сарычева «Новые правила деловой переписки»** (2018) — email structure, respectful tone, messenger etiquette — [buy: book.glvrd.ru](https://book.glvrd.ru)
12. **Нора Галь «Слово живое и мёртвое»** (1972, reprints) — original critique of канцелярит, nominalization abuse, passive voice — [lib.ru/TRANSLATORS/NORA_GAL/slowo.txt](http://lib.ru/TRANSLATORS/NORA_GAL/slowo.txt)
13. **Д. Э. Розенталь — Справочники по правописанию** (1960s–2000s) — authoritative Russian grammar, punctuation, orthography baseline — buy: widely available
14. **Артемий Лебедев «Ководство»** (1998–present) — screen typography, dashes and quotes, design-text readability — [artlebedev.ru/kovodstvo](https://www.artlebedev.ru/kovodstvo/)
15. **Ozon — UX Writing Practices** (2021–present) — UX writing at scale: buttons, notifications, errors, product copy — [habr.com](https://habr.com)
16. **ГОСТ Р 7.0.12-2011, ГОСТ 7.12-93** (Росстандарт) — official standards for bibliographic abbreviations in Russian — ГОСТ databases

## Online Tools

- **Главред** ([glvrd.ru](https://glvrd.ru)) — checks text for info-style quality, highlights filler and канцелярит, scores 0–10
- **Типограф Лебедева** ([typograf.artlebedev.ru](https://typograf.artlebedev.ru)) — auto-fixes typography: quotes, dashes, non-breaking spaces
- **Орфограммка** ([orfogrammka.ru](https://orfogrammka.ru)) — grammar, spelling, punctuation checker beyond basic spellcheck


path: references/typography.md
content: # Правила русской типографики для цифровых текстов

## Contents
- [A. Кавычки](#a-кавычки)
- [B. Тире и дефис](#b-тире-и-дефис)
- [C. Пробелы](#c-пробелы)
- [D. Многоточие (ellipsis)](#d-многоточие-ellipsis)
- [E. Числа и даты](#e-числа-и-даты)
- [F. Сокращения](#f-сокращения)
- [G. Специальные символы](#g-специальные-символы)
- [Принципы наращения порядковых числительных](#принципы-наращения-порядковых-числительных)
- [Sources](#sources)

## A. Кавычки

### A.1. Основные -- «ёлочки»
R1. Основные кавычки в русском тексте -- `« »` (U+00AB, U+00BB). `"Война и мир"` -> `«Война и мир»`
R2. Английские фигурные `" "` недопустимы в русском тексте. `"Правда"` -> `«Правда»`
R3. Даже в коротких фразах -- ёлочки. `Он сказал: "Идём"` -> `Он сказал: «Идём»`

### A.2. Вложенные -- „лапки"
R4. Внутренние кавычки -- „лапки" `„ "` (U+201E, U+201C). `«Роман «Онегин»»` -> `«Роман „Онегин"»`
R5. Третий уровень вложенности -- одинарные ёлочки `‹ ›` или повторные „лапки". Пример: `«Бахтин писал: „Тришатов: ‹Любите вы музыку?›"»`

### A.3. Запрещённые виды кавычек

R6|`"..."`|прямые (dumb quotes)|допустимы только в коде, CLI, конфигах
R7|`"..."`|английские фигурные|только в англоязычных цитатах
R8|`'...'`|одинарные английские|только в англоязычных цитатах

### A.4. Технические контексты
R9. В блоках кода (`code`, `<pre>`) -- прямые кавычки `"` и `'` (часть синтаксиса).
R10. В именах файлов, URL, командах терминала -- прямые кавычки.
R11. В UI (названия кнопок, пунктов меню) -- ёлочки: нажмите «Сохранить».

### A.5. Пробелы и кавычки
R12. Кавычки без пробелов от текста. `« Текст »` -> `«Текст»` (в отличие от французской традиции с тонкими пробелами).

---

## B. Тире и дефис

Сводная таблица знаков-штрихов:

знак|unicode|html|название|применение
`-`|U+002D|`-`|дефис (hyphen-minus)|составные слова, переносы
`–`|U+2013|`&ndash;`|короткое тире (en dash)|диапазоны: 2020–2025
`—`|U+2014|`&mdash;`|длинное тире (em dash)|пунктуация в предложениях
`−`|U+2212|`&minus;`|минус (minus sign)|математика: −5, a − b

### B.1. Длинное тире (em dash, U+2014)
R13. Длинное тире `—` обрамляется пробелами. `Москва-столица` -> `Москва — столица`
R14. Два дефиса -- не замена тире. `Москва--столица` -> `Москва — столица`
R15. Дефис с пробелами вместо тире -- ошибка. `Он пришёл - и все замолчали` -> `Он пришёл — и все замолчали`
R16. Пробел перед тире -- неразрывный (иначе тире на новой строке читается как прямая речь).

Применение длинного тире:
R17. Между подлежащим и сказуемым без связки: *Жизнь — борьба*
R18. Пауза, разделение частей: *Я хотел позвонить — но передумал*
R19. Прямая речь: *— Добрый день! — сказал он*
R20. Вводные конструкции: *Этот город — как я уже говорил — очень красив*

### B.2. Короткое тире (en dash, U+2013)
R21. Короткое тире для числовых/временных диапазонов, без пробелов. `2020-2025` -> `2020–2025`
R22. Диапазоны страниц: `с. 10-15` -> `с. 10–15`
R23. Составные наименования с именами собственными: `Алёхин-Капабланка` -> `Алёхин–Капабланка`
R24. Века: `XI-XIII века` -> `XI–XIII века`
R25. Маршруты: `Москва-Петербург` -> `Москва–Петербург`
R26. Временные интервалы: `10:00-18:00` -> `10:00–18:00`

### B.3. Дефис (hyphen, U+002D)
R27. Дефис только для составных слов, приставок/суффиксов, переносов: кое-что, по-русски, генерал-лейтенант, из-за, кто-нибудь, Ростов-на-Дону.

### B.4. Минус (minus sign, U+2212)
R28. В математике -- специальный знак минуса `−`, не дефис и не тире. `-5 °C` -> `−5 °C`
R29. Минус по ширине совпадает с `+` и `=`: `10 − 3 = 7`, `a − b`.

---

## C. Пробелы

### C.1. Неразрывный пробел после однобуквенных предлогов/союзов
R30. После в, к, с, о, у, и, а, я -- неразрывный пробел (U+00A0), чтобы не оказывались на конце строки. `в<nbsp>Москве`, `к<nbsp>сожалению`, `я<nbsp>думаю`

### C.2. Неразрывный пробел в инициалах
R31. Инициалы и фамилия связываются nbsp: `А.<nbsp>С.<nbsp>Пушкин` (не `А. С.<перенос>Пушкин`).

### C.3. Тонкий неразрывный пробел в числах
R32. Группы по 3 цифры разделяются тонким nbsp (U+202F) или обычным nbsp. `1,000,000` -> `1 000 000`
R33. Точка как разделитель -- немецкий стандарт, недопустим. `1.000.000` -> `1 000 000`
R34. Числа от 10 000 разделяются. `25400` -> `25 400`
R35. Четырёхзначные (1000–9999) допустимо без разделителя, но при наличии крупных чисел -- единообразно разделять все.

### C.4. Неразрывный пробел перед единицами измерения
R36. Число и единица связываются nbsp: `5кг` -> `5<nbsp>кг`
R37. Процент: `100%` -> `100<nbsp>%`
R38. Температура: `20°C` -> `20<nbsp>°C`
R39. Площадь, время: `50<nbsp>м²`, `3<nbsp>ч 20<nbsp>мин`

### C.5. Пробелы и знаки препинания
R40. Нет пробела ПЕРЕД: `.` `,` `:` `;` `!` `?` -- `Привет !` -> `Привет!`
R41. Пробел ПОСЛЕ: `.` `,` `:` `;` `!` `?` -- `Привет!Как дела?` -> `Привет! Как дела?`
R42. Нет пробела перед закрывающей скобкой/кавычкой: `(текст )` -> `(текст)`
R43. Нет пробела после открывающей скобки/кавычки: `( текст)` -> `(текст)`

### C.6. Неразрывный пробел перед тире
R44. Пробел перед длинным тире -- неразрывный, чтобы тире не переносилось на новую строку.

---

## D. Многоточие (ellipsis)

### D.1. Символ многоточия
R45. Единый символ `…` (U+2026), не три точки. `Ну что ж...` -> `Ну что ж…`
R46. Две точки -- тоже ошибка. `Может быть..` -> `Может быть…`

### D.2. Пробелы и многоточие
R47. В конце предложения -- без пробела перед: `Он ушёл…`
R48. В начале (продолжение) -- без пробела после: `…и тогда он вернулся`
R49. В середине (пропуск) -- без пробелов вокруг: `Он… впрочем, неважно`
R50. После многоточия новое предложение -- пробел перед заглавной: `Он ушёл… Она осталась`

### D.3. Многоточие с ?/!
R51. После `?` или `!` -- две точки, а не три: `Неужели?...` -> `Неужели?..`
R52. Аналогично: `Как же так!...` -> `Как же так!..`

---

## E. Числа и даты

### E.1. Разделитель разрядов
R53. Разряды разделяются пробелами (тонкими неразрывными). Запятые и точки не используются. `1,000,000` -> `1 000 000`

### E.2. Десятичный разделитель
R54. Десятичный разделитель -- запятая: `3.14` -> `3,14`; `0.5` -> `0,5`; `99.9 %` -> `99,9 %`

### E.3. Порядковые числительные
R55. К цифре через дефис -- падежное окончание: `1й` -> `1-й этаж`
R56. Если предпоследняя буква числительного -- согласная, окончание в одну букву: 5-й, 5-я, 5-е, 5-м. `2-ая` -> `2-я линия`
R57. Если предпоследняя буква -- гласная, окончание в две буквы: 2-го, 2-му. `10-ом` -> `10-м`
R58. К римским цифрам наращение не добавляется: `XXI-й век` -> `XXI век`

### E.4. Даты
R59. Полная дата в тексте: `15 марта 2026 года`. Короткая для таблиц/форм: `15.03.2026`.
R60. Не смешивать форматы: `15.03.2026 года` -- ошибка.
R61. Слеш -- не разделитель дат: `15/03/2026` -> `15.03.2026`
R62. Диапазон лет -- короткое тире: `2025-2026 гг.` -> `2025–2026 гг.`
R63. Десятилетия -- краткое наращение: `90-ые годы` -> `90-е годы`

### E.5. Время
R64. Разделитель -- двоеточие: `14.30` -> `14:30`
R65. Ноль перед минутами: `9:5` -> `9:05`
R66. Полный формат для расписаний: `с 10 до 18` -> `с 10:00 до 18:00`

### E.6. Телефонные номера
R67. Формат: `+7 (999) 123-45-67`. Не `+79991234567`, не `8-999-123-45-67`. Для 8-800: `8 800 123-45-67`.

### E.7. Денежные суммы
R68. Знак рубля после числа через nbsp: `₽1 500` -> `1 500 ₽`
R69. Пробел перед словесным сокращением: `1 500руб.` -> `1 500 руб.`
R70. Запятая как десятичный разделитель в суммах: `99.90 ₽` -> `99,90 ₽`
R71. Доллар -- символ перед числом: `100$` -> `$100`
R72. Евро -- после числа с пробелом: `100€` -> `100 €`

---

## F. Сокращения

### F.1–F.4. Сводная таблица сокращений

**С точками (части через nbsp):**

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

R73. Между частями сокращений с точками -- неразрывный пробел: `и т.д.` -> `и т. д.`

**Единицы измерения (без точек):**

R74. Единицы измерения пишутся без точки: кг, м, км, с, мин, ч, л, га. `кг.` -> `кг`

**Академические и профессиональные:**

сокр.|полная форма
д-р|доктор
проф.|профессор
канд.|кандидат
акад.|академик
доц.|доцент
гл.|глава
ред.|редактор
изд.|издание

R75. Академические сокращения с точкой (кроме дефисных): проф., канд., акад., доц., гл., ред., изд.; но: д-р.

**Географические и адресные:**

сокр.|полная форма|пример
г.|город|г. Москва
ул.|улица|ул. Ленина
д.|дом|д. 5
кв.|квартира|кв. 12
пр. / пр-т|проспект|пр. Мира
пер.|переулок|пер. Сивцев Вражек
обл.|область|Московская обл.

R76. Географические сокращения с точкой: г., ул., д., кв., пр., пер., обл.

### F.5. Сокращения в заголовках
R77. В заголовках и подзаголовках сокращения раскрывать полностью: `Канд. наук и его роль` -> `Кандидат наук и его роль`

---

## G. Специальные символы

Сводная таблица спецсимволов:

символ|unicode|html|название
«|U+00AB|`&laquo;`|открывающая ёлочка
»|U+00BB|`&raquo;`|закрывающая ёлочка
„|U+201E|`&bdquo;`|открывающая лапка
"|U+201C|`&ldquo;`|закрывающая лапка
—|U+2014|`&mdash;`|длинное тире
–|U+2013|`&ndash;`|короткое тире
−|U+2212|`&minus;`|минус
(nbsp)|U+00A0|`&nbsp;`|неразрывный пробел
(nnbsp)|U+202F|--|тонкий неразрывный пробел
…|U+2026|`&hellip;`|многоточие
'|U+2019|`&rsquo;`|апостроф
°|U+00B0|`&deg;`|градус
×|U+00D7|`&times;`|знак умножения
№|U+2116|`&#8470;`|знак номера
©|U+00A9|`&copy;`|copyright
™|U+2122|`&trade;`|trademark
®|U+00AE|`&reg;`|registered
•|U+2022|`&bull;`|маркер списка (bullet)

### G.1. Апостроф
R78. Правильный апостроф -- `'` (U+2019), не машинописный `'` (U+0027): `О'Генри` -> `О'Генри`, `д'Артаньян` -> `д'Артаньян`

### G.2. Знак градуса
R79. Градус -- `°` (U+00B0). Не `^o`, не `0`.
R80. Число + градус + шкала -- nbsp от числа: `20°C` -> `20 °C`
R81. Угол -- без пробела: `360°`, `90°`

### G.3. Знак умножения
R82. Знак умножения `×` (U+00D7), не латинская `x`: `5 x 3` -> `5 × 3`
R83. Разрешение экрана: `1920x1080` -> `1920 × 1080`
R84. Не звёздочка: `3 * 4 м` -> `3 × 4 м`

### G.4. Знак номера
R85. В русском -- `№` (U+2116), не `N` и не `#`: `#5` -> `№ 5`, `N 5` -> `№ 5`
R86. После `№` -- неразрывный пробел перед цифрой: `дом №12` -> `дом № 12`

### G.5. Знаки авторского права и торговых марок
R87. Copyright: `©` (U+00A9). `(С) 2026` -> `© 2026`
R88. Trademark: `™` (U+2122). Пример: `Бренд™`
R89. Registered: `®` (U+00AE). Пример: `Марка®`

### G.6. Маркер списка
R90. Для маркированных списков -- символ `•` (U+2022), не дефис и не звёздочка.
R91. В Markdown и plain text `-` или `*` допустимы (часть синтаксиса разметки).

---

## Принципы наращения порядковых числительных

R92. Наращение через дефис: `5-й`, `2-го`.
R93. После согласной предпоследней буквы -- одна буква: 5-й, 5-я, 5-е, 5-м.
R94. После гласной предпоследней буквы -- две буквы: 2-го, 2-му.
R95. Римские цифры без наращения: XXI век.
R96. Десятилетия -- краткое наращение: 90-е годы, не 90-ые.

## Sources
See [sources.md](sources.md)


path: references/ux-writing.md
content: # UX-writing на русском языке

Справочник по написанию интерфейсных текстов на русском языке.

## Contents
- [A. Основные принципы UX-writing на русском](#a-основные-принципы-ux-writing-на-русском)
- [B. Кнопки (Button labels)](#b-кнопки-button-labels)
- [C. Сообщения об ошибках (Error messages)](#c-сообщения-об-ошибках-error-messages)
- [D. Пустые состояния (Empty states)](#d-пустые-состояния-empty-states)
- [E. Подсказки и тултипы (Tooltips and hints)](#e-подсказки-и-тултипы-tooltips-and-hints)
- [F. Уведомления и тосты (Notifications and toasts)](#f-уведомления-и-тосты-notifications-and-toasts)
- [G. Элементы форм (Form elements)](#g-элементы-форм-form-elements)
- [H. Загрузка и прогресс (Loading and progress)](#h-загрузка-и-прогресс-loading-and-progress)
- [I. Диалоги подтверждения (Confirmation dialogs)](#i-диалоги-подтверждения-confirmation-dialogs)
- [J. Единообразие терминов (Terminology consistency)](#j-единообразие-терминов-terminology-consistency)
- [K. Особенности UX-writing на русском языке](#k-особенности-ux-writing-на-русском-языке)
- [L. Типографика](#l-типографика)
- [M. Краткая памятка для самопроверки](#m-краткая-памятка-для-самопроверки)
- [Sources](#sources)

---

## A. Основные принципы UX-writing на русском

1. **Текст — элемент дизайна, а не украшение.** Если текст можно убрать без потери смысла — его быть не должно. Если нельзя — он заслуживает такого же внимания, как визуальная композиция экрана.
2. **За текст отвечает вся продуктовая команда.** Формулировки закладываются одновременно с проектированием сценария, не «на потом». Дизайнер, редактор и разработчик работают над текстом совместно.
3. **Говорите на языке пользователя.** Общеупотребительные слова приоритетнее технических терминов. Профессиональный жаргон аудитории допустим, внутренний жаргон компании — нет.
4. **Активный залог и первое лицо.** «Сохранить изменения» лучше «Изменения будут сохранены». Допустимо: «Мои заказы», «Мой профиль».
5. **Единообразие терминов.** Одно понятие — одно название на всех экранах, во всех состояниях, во всех каналах.
6. **Каждое слово работает.** Важное — в начало фразы. Убирайте слова без нового смысла. Не минимальная длина — максимальная ясность.
7. **Превращайте негатив в нейтральное/позитивное.** «Информация доступна ещё 5 дней» вместо «Информация исчезнет через 5 дней». Без искажения смысла.
8. **Информируйте, зачем.** Запрашиваете данные — объясните, для чего. Ограничиваете действие — назовите причину.

---

## B. Кнопки (Button labels)

### Общие правила
1. Текст на кнопке — решение пользователя, глагол в инфинитиве: **Сохранить**, **Отправить**, **Удалить**.
2. Проверка: «Ок, [текст кнопки]» — если звучит естественно, формулировка верная.
3. Кнопка-подтверждение (интерфейс информирует) может быть наречием: **Понятно**, **Хорошо**.
4. Заголовок экрана и кнопка связаны по смыслу. Допустимо повторять ключевое слово.
5. Пара «действие / отмена»: действие конкретно, отмена — всегда **Отмена** (не «Нет», не «Отменить»).
6. Деструктивные действия: указывайте объект — **Удалить проект**, не просто **Удалить**.

### Справочная таблица кнопок

| en|ru |
|---|---|
| Save|Сохранить |
| Save as|Сохранить как |
| Cancel|Отмена (НЕ «Отменить» — это undo) |
| Undo|Отменить (возврат к предыдущему состоянию) |
| Redo|Повторить (вернуть отменённое) |
| Delete|Удалить (уточняйте объект: «Удалить файл») |
| Create|Создать |
| Add|Добавить («в корзину», «участника») |
| Edit|Редактировать (или «Изменить» — одно на весь продукт) |
| Change|Изменить (не путать с «Редактировать») |
| Send / Submit|Отправить |
| Download|Скачать (НЕ «Загрузить» — двусмысленно) |
| Upload|Загрузить (на сервер) |
| Copy|Копировать |
| Paste|Вставить |
| Move|Переместить |
| Rename|Переименовать |
| Share|Поделиться |
| Open|Открыть |
| Close|Закрыть |
| Sign in|Войти (НЕ «Аутентифицироваться») |
| Sign out|Выйти |
| Sign up|Зарегистрироваться (или «Создать аккаунт») |
| Continue|Продолжить |
| Back|Назад |
| Next|Далее |
| Done|Готово (завершение многошагового процесса) |
| Apply|Применить (фильтры, настройки) |
| Reset|Сбросить («Сбросить фильтры») |
| Refresh / Update|Обновить |
| Search / Find|Найти |
| Subscribe|Подписаться |
| Unsubscribe|Отписаться |
| Expand|Развернуть |
| Collapse|Свернуть |
| Confirm|Подтвердить |
| Retry|Попробовать снова (или «Повторить попытку») |
| Skip|Пропустить |
| Buy|Купить |
| Pay|Оплатить |
| Checkout|Оформить заказ |
| Restore|Восстановить |
| Block|Заблокировать |
| Unblock|Разблокировать |
| Configure|Настроить |
| Select|Выбрать |
| Accept|Принять (приглашения, условия) |
| Decline|Отклонить |
| Learn more|Подробнее (ссылка, не кнопка основного действия) |
| Got it|Понятно (подтверждение информационного сообщения) |
| Archive|Архивировать (не удалять, а скрыть из активных) |
| Favorite / Unfavorite|В избранное / Убрать из избранного |
| Mute / Unmute|Без звука / Со звуком (уведомления, чат) |
| Report|Пожаловаться (на контент, пользователя) |
| Add to cart|В корзину |
| Add to wishlist|В список желаний |
| Filter|Фильтровать (или «Применить фильтры») |
| React|Отреагировать (эмодзи-реакции — без текста кнопки, только иконки) |

---

## C. Сообщения об ошибках (Error messages)

### Структура: 1) что произошло, 2) почему (если полезно), 3) что делать.

### Принципы
1. Нейтральный тон: не обвиняйте пользователя («Вы ввели неправильно» → «Неверный формат»).
2. Конкретика: называйте ограничения, форматы, допустимые значения.
3. Заголовки разных ошибок должны отличаться. Одинаковые «Не удалось...» — пользователь перестаёт различать, поддержка не может идентифицировать.
4. Экран ошибки — разновидность пустого состояния: помогите двинуться дальше.

### Формулировки: плохо|хорошо|почему

| bad|good|why |
|---|---|---|
| Ошибка|Не удалось сохранить файл. Проверьте подключение|причина+действие |
| Неверный формат|Загрузите JPG, PNG или WebP|называет решение |
| Произошла ошибка. Попробуйте позже|Сервер не отвечает. Попробуйте через пару минут или в поддержку|ориентир+план |
| Ошибка загрузки|Файл слишком большой. Максимум — 25 МБ|ограничение |
| Неверный пароль|Неверный пароль. Сбросьте по ссылке|предлагает выход |
| Ошибка ввода|Телефон: +7, 11 цифр|ожидаемый формат |
| Недопустимые символы|Имя: буквы, дефис, пробел|допустимое |
| Поле обязательно|Укажите email|конкретное поле |
| Ошибка оплаты|Проверьте баланс или попробуйте другой способ|два варианта |
| Что-то пошло не так|Не загрузилась страница. Обновите или вернитесь позже|действие+запас |
| Ошибка авторизации|Не удалось войти. Проверьте логин и пароль|что проверить |
| Данные не сохранены|Потеря соединения. Мы сохранили черновик|причина+автодействие |
| Нет доступа|Нет доступа. Обратитесь к администратору|кто поможет |
| Неверная дата|Дата — не раньше сегодняшнего дня|ограничение |
| Превышен лимит|Максимум 10 участников. Удалите кого-то|лимит+выход |
| Ошибка сети|Нет интернета. Проверьте Wi-Fi или мобильную сеть|действия |
| Письмо не отправлено|Проверьте адрес получателя|вероятная причина |
| Ошибка 404|Страница не найдена. Удалена или адрес с ошибкой|человеческий 404 |
| Ошибка 500|Сбой на нашей стороне. Разбираемся, попробуйте позже|честность |

---

## D. Пустые состояния (Empty states)

### Принципы
1. Объясните, что здесь будет, когда появятся данные.
2. Предложите первое действие — кнопку или ссылку.
3. Тон ободряющий, не заискивающий. Без восклицательных знаков, смайлов, нарочитой «дружелюбности».
4. Пустое состояние — точка входа, а не тупик.

### Примеры
- **Пустой список:** «Нет новых уведомлений» + «Здесь появятся уведомления о заказах, доставке и акциях»
- **Пустой поиск:** «Ничего не нашлось по запросу «[запрос]»» + «Измените запрос или проверьте написание» + [Сбросить фильтры]
- **Новый аккаунт:** «У вас пока нет проектов» + [Создать проект]
- **Нет данных за период:** «Нет данных за выбранный период» + «Выберите другой диапазон»
- **Пустая корзина:** «Корзина пуста» + [Перейти в каталог]
- **Пустое избранное:** «В избранном пока пусто» + «Нажмите на сердечко у товара»

---

## E. Подсказки и тултипы (Tooltips and hints)

### Правила
1. Максимум 1–2 предложения. Больше — справочная статья.
2. Объясняйте «зачем», а не «что»: пользователь видит элемент, но может не понимать назначение.
3. Не дублируйте написанное на экране. Тултип «Кнопка сохранения» к кнопке «Сохранить» — бесполезен.
4. Нельзя прятать в тултип критически важную информацию: пользователь может его не увидеть.

### Типы подсказок

| Тип|Триггер|Когда |
|---|---|---|
| Тултип|hover|Пояснение к иконке, сокращению, настройке |
| Хинт|постоянно виден|Формат ввода, ограничения, пояснение к полю |
| Инлайн-подсказка|всегда видна|Важные предупреждения, нельзя пропустить |
| Обучающий тултип|первое посещение/обновление|Знакомство с новой функцией |

### Примеры
- Тултип к замку: «Данные передаются по защищённому соединению»
- Хинт под ИНН: «10 цифр для организации, 12 — для ИП»
- Тултип к переключателю: «Если включено, уведомления будут приходить и по ночам»

### Пунктуация
Точка в тултипе — только между предложениями, не в конце. Исключение: полноценный текст из 2+ абзацев — обычные правила пунктуации.

---

## F. Уведомления и тосты (Notifications and toasts)

### Типы
1. **Успех:** кратко, конкретно, без пафоса. «Файл сохранён», не «Операция выполнена успешно». Если действие очевидно — уведомление может не требоваться.
2. **Ошибка:** обязательно содержит действие или подсказку к решению.
3. **Инфо:** только если пользователь должен это знать прямо сейчас. Избыток вызывает «уведомительную слепоту».
4. **Предупреждение:** сообщите о риске и как его избежать.

### Формат
5. Тост: текст читается за 3–5 секунд.
6. Не блокируйте действия, тост не перекрывает важный контент.
7. Нужны подробности — ссылка «Подробнее», не длинный текст.

### Примеры

| Тип|Плохо|Хорошо |
|---|---|---|
| Успех|Операция выполнена успешно|Изменения сохранены |
| Успех|Действие завершено|Письмо отправлено |
| Ошибка|Ошибка|Не удалось удалить файл. Попробуйте ещё раз |
| Инфо|Внимание! Важная информация!|Завтра в 03:00 планируются технические работы |
| Предупреждение|Осторожно!|Осталось 3 дня до окончания подписки. [Продлить] |

---

## G. Элементы форм (Form elements)

### Плейсхолдер
1. Показывает **пример** заполнения, не инструкцию. Хорошо: `Иван Петров`. Плохо: `Введите имя`.
2. Исчезает при вводе — не размещайте критически важную информацию.

### Лейбл
3. Существительное или короткая именная группа: «Электронная почта», «Дата рождения».
4. Не команда: «Электронная почта», а не «Введите электронную почту».
5. Обязательные поля не помечайте, если обязательны почти все. Помечайте необязательные.

### Валидация
6. Мгновенная, не по отправке формы.
7. Сообщение рядом с полем, не в общем блоке наверху.
8. Называйте формат: «email в формате [REDACTED_SECRET]».
9. Не показывайте ошибку до начала ввода, но и не ждите завершения.

### Подпись к полю (help text)
10. Под полем. Объясняет «зачем» или формат.
11. Видна одновременно с полем, не по запросу.

### Примеры полей

| Элемент|Лейбл|Плейсхолдер|Подпись |
|---|---|---|---|
| Email|Электронная почта|[REDACTED_SECRET]|На эту почту придёт подтверждение |
| Телефон|Телефон|+7 900 123-45-67| |
| Пароль|Пароль| |Минимум 8 символов, хотя бы одна цифра |
| ИНН|ИНН|7707083893|10 цифр для юрлица, 12 для ИП |
| Дата|Дата рождения|15.03.1990| |
| Комментарий|Комментарий к заказу (необязательно)|Домофон не работает, позвоните| |

---

## H. Загрузка и прогресс (Loading and progress)

### Принципы
1. Сообщайте, какой процесс идёт — пользователь не должен гадать.
2. Больше 2–3 секунд — текстовое пояснение.
3. Можно показать прогресс (процент, шаги) — показывайте.
4. Длительные операции: укажите типичное время.

### Формулировки

| Ситуация|Плохо|Хорошо |
|---|---|---|
| Загрузка данных|*(спиннер)*|Загружаем документы... |
| Отправка формы|Загрузка...|Отправляем заявку... |
| Генерация отчёта|Подождите|Формируем отчёт. Обычно 1–2 минуты |
| Импорт|Обработка...|Импортируем данные: 45 из 120 записей |
| Экспорт|Подождите|Готовим файл для скачивания... |
| Длительная операция|*(ничего)*|Проверяем данные. До 5 минут, можно закрыть — пришлём уведомление |

### Пошаговый прогресс
5. Если несколько этапов — показывайте шаг: «Шаг 2 из 4: Проверяем реквизиты...»

---

## I. Диалоги подтверждения (Confirmation dialogs)

### Структура
1. **Заголовок:** что произойдёт — вопрос: «Удалить проект?», «Отменить подписку?».
2. **Тело:** последствия. Конкретика: что именно затронуто.
3. **Кнопки:** конкретное действие + Отмена. **Никогда** «Да / Нет».

### Когда подтверждения не нужны
4. Действие обратимо — дайте undo после выполнения, не подтверждение до.
5. Действие частое/серийное — подтверждение раздражает и замедляет.

### Усиление подтверждения
6. Особо опасные действия: покажите конкретику — список удаляемого, количество записей, имена получателей.

### Примеры

**Удаление (необратимое):**
> **Удалить проект «Альфа»?**
> Будут удалены все файлы и история (12 файлов, 47 версий). Нельзя отменить.
> [Удалить проект] [Отмена]

**Отмена подписки:**
> **Отменить подписку?**
> Активна до 15 апреля. После — доступ к платным функциям прекратится.
> [Отменить подписку] [Оставить подписку]

**Выход без сохранения:**
> **Выйти без сохранения?**
> Несохранённые изменения будут потеряны.
> [Выйти] [Вернуться к редактированию]

**Массовое действие:**
> **Отправить рассылку 1 240 получателям?**
> Отменить рассылку после отправки невозможно.
> [Отправить] [Отмена]

---

## J. Единообразие терминов (Terminology consistency)

### Принцип «одно понятие — одно слово»
1. Назвали «проект» — он «проект» везде: навигация, заголовки, ошибки, уведомления, письма. Не чередуйте с синонимами. В интерфейсе повторяемость — достоинство.

### Глоссарий продукта
2. Ведите глоссарий. Минимум: термин, определение, где используется в UI, что НЕ использовать.

### Локализация vs транслитерация
3. **Русское слово** — если не длиннее англицизма более чем в 1,5 раза, привычно аудитории, однозначно.
4. **Транслитерация** — если русский значительно длиннее, термин прочно вошёл в язык, русский вариант неестественен.
5. **Проверяйте** частотность по словарям и поисковикам. «Лендинг» — устоявшееся; «лэндинг» — менее частотное.

### Частые проблемные пары

| Ситуация|Рекомендация |
|---|---|
| Авторизация vs аутентификация|В UI: «Вход». Техразличия не нужны пользователю |
| Загрузить (upload) vs загрузить (download)|**загрузить** (на сервер) и **скачать** (на устройство) |
| Логин vs имя пользователя|Одно на весь продукт |
| Аккаунт vs учётная запись|«Аккаунт» — потребительские; «Учётная запись» — корпоративные |
| Нотификация vs уведомление|«Уведомление» — общеупотребительное |
| Баг vs ошибка|Для пользователя — «ошибка» или «сбой» |
| Дашборд vs панель|«Панель» или «Сводка» — по контексту |
| Паттерн vs шаблон|«Шаблон» — для пользовательского интерфейса |

---

## K. Особенности UX-writing на русском языке

### Обращение: «вы» или «ты»

| Критерий|«Ты»|«Вы» |
|---|---|---|
| Аудитория|Молодая, неформальная|Широкая, разновозрастная, профессиональная |
| Тон|Дружеский|Нейтральный, деловой |
| Примеры|Telegram, VK, игры|Банки, госуслуги, B2B |

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

### Гендер в интерфейсных текстах
3. **Безличные конструкции** (самый универсальный): «Заказ оформлен» вместо «Вы оформили заказ».
4. **Инфинитив:** «Для продолжения необходимо подтвердить email».
5. **Множественное число:** «Вы вошли в систему» (не «вошёл/вошла»).
6. Пол из профиля — допустимо согласование, но требует технической реализации.

### Длина слов: русский на ~30% длиннее английского
7. **Кнопки:** «Зарегистрироваться» (17) vs «Sign up» (7) — закладывайте запас ширины.
8. **Навигация:** пункты меню могут не влезать.
9. **Мобильные экраны:** критично для маленьких разрешений.
10. **Таблицы:** заголовки столбцов на русском занимают больше.
11. Решения: сокращайте формулировки, используйте общепринятые сокращения, тестируйте с реальным русским текстом, не Lorem ipsum.

### Типичные проблемы при локализации с английского
12. **Калькирование:** «Это действие не может быть отменено» → «Это действие нельзя отменить».
13. **Артикли:** «the file» → «файл», не «этот файл» или «данный файл» (канцелярит).
14. **Порядок слов:** русский свободный — ставьте важное в начало.
15. **Множественное число:** 3 формы (1 файл, 2 файла, 5 файлов) — не забывайте о плюрализации в шаблонах.

### Ложные друзья переводчика

| English|Неправильно|Правильно |
|---|---|---|
| Accurate|Аккуратный|Точный |
| Actually|Актуально|На самом деле |
| Application|Аппликация|Приложение / Заявка |
| Data|Дата|Данные |
| Magazine|Магазин|Журнал |
| Replica|Реплика|Копия / Точная копия |

---

## L. Типографика

Полные правила русской типографики см. в [typography.md](typography.md).
UX-специфичные дополнения ниже:

1. В заголовках точка не ставится.
2. В подписях (тосты, хинты, тултипы): точка только между предложениями, не в конце.
3. Решение об использовании Ё принимается на уровне продукта и фиксируется в редполитике.
4. Обязательно ставьте Ё, когда возможны разночтения (всё vs все, передохнём vs передохнем).
5. Обязательно ставьте Ё в именах собственных.
6. Используйте символ ₽, не «руб.» или «р.». Знак после числа через пробел: 1 500 ₽.

---

## M. Краткая памятка для самопроверки

- [ ] Текст понятен с первого прочтения без дополнительного контекста?
- [ ] Важное стоит в начале фразы?
- [ ] Нет слов, которые можно убрать без потери смысла?
- [ ] Термины совпадают с глоссарием продукта?
- [ ] Кнопки содержат глагол (или наречие для подтверждения)?
- [ ] Ошибки содержат действие — что делать дальше?
- [ ] Пустые состояния предлагают первый шаг?
- [ ] Заголовок и кнопка связаны по смыслу?
- [ ] Текст уместится на всех экранах, включая мобильные?
- [ ] Не используются «Да / Нет» в диалогах подтверждения?
- [ ] Плейсхолдер содержит пример, а не инструкцию?
- [ ] Форма обращения («вы» / «ты») единообразна?

## Sources
See [sources.md](sources.md)


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)