Как устроена хорошая статья

Хорошая статья решает одну понятную задачу читателя. До начала работы сформулируйте, для кого вы пишете, какую проблему разбираете и с чем читатель уйдёт после прочтения.

Перед началом

Ответьте одним предложением на три вопроса:

1. Кто читатель и что он уже знает о теме?
2. Какой вопрос или затруднение привели его к статье?
3. Какое действие, решение или понимание он получит в конце?

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

Заголовок

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

Хороший заголовок:

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

Слабо: «Несколько мыслей о разработке»

Лучше: «Как сократить время ревью React-компонентов: чек-лист для команды»

Лид-абзац

Лид — краткий анонс под заголовком. Его длина ограничена 500 символами. За два–три предложения дайте читателю контекст:

• какую проблему разбирает статья;
• почему она важна;
• что именно читатель узнает или сможет сделать.

Не начинайте с длинной истории появления темы. Сначала обозначьте ценность, затем переходите к деталям.

Каркас основной части

Для большинства практических материалов подходит такая последовательность:

1. Контекст. Опишите исходную ситуацию и ограничения.
2. Проблема. Покажите, что именно не работает или требует решения.
3. Подход. Объясните ход рассуждений и выбранный способ.
4. Практика. Дайте шаги, примеры, код, данные или иллюстрации.
5. Результат. Сравните состояние до и после, назовите ограничения.
6. Вывод. Кратко соберите главные мысли и следующий шаг.

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

Подзаголовки H2 и H3

Используйте H2 для крупных смысловых разделов, а H3 — только для подразделов внутри H2. Подзаголовок должен сообщать, что читатель найдёт дальше; формулировки «Введение» или «Разное» обычно слишком общие.

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

Абзацы и переходы

Один абзац — одна мысль. Начинайте абзац с главного, а затем приводите объяснение или пример. Между разделами добавляйте короткий переход, если связь неочевидна.

Для длинных перечислений используйте списки. Для сравнения нескольких параметров — компактную таблицу. Подробности оформления собраны на странице «Оформление и читаемость».

Завершение

В финале не пересказывайте статью целиком. Достаточно:

• назвать главный вывод;
• напомнить об ограничениях решения;
• предложить читателю понятный следующий шаг.

Быстрая самопроверка

• Заголовок и лид обещают именно то, что есть в тексте.
• В статье одна основная тема и понятная аудитория.
• Разделы идут в логичном порядке.
• Каждый пример помогает доказать или объяснить мысль.
• Вывод отвечает на вопрос, поставленный в начале.

Перед отправкой также проверьте правила публикации.