Источник
Пирамида Минто
Разбор принципа структурирования текстов: сначала ответ, потом аргументы.
Источник
Пирамида Минто
Разбор принципа структурирования текстов: сначала ответ, потом аргументы.
Пирамида Минто помогает писать так, чтобы читатель быстро понял суть: сначала главный вывод, затем доказательства и детали. Для инженерной документации это особенно важно, потому что время читателя ограничено, а цена недопонимания обычно высокая.
TL;DR
- Сначала ответ, потом доказательства: это снижает когнитивную нагрузку читателя.
- SCQA задает рамку, тезис определяет направление, аргументы подтверждают решение.
- Текст по Минто ускоряет согласования в RFC, ADR, strategy notes и статус-апдейтах.
Базовый каркас пирамиды
Введение
Контекст и вопрос: что происходит, почему проблема важна и о чем документ.
Главный тезис
Короткий, проверяемый вывод, который отвечает на вопрос из вводной части.
Аргументы
Группы фактов и логики, которые последовательно доказывают тезис.
Введение через SCQA
Для вводной части удобно использовать Situation -> Complication -> Question -> Answer. Такой вход сразу задает рамку и избавляет читателя от "угадывания" смысла.
Situation
В компании задерживаются релизы и растет очередь инициатив.
Complication
Требования хаотичны, решения теряются между командами и каналами.
Question
Как сократить time-to-release без роста операционного хаоса?
Answer
Ввести единый стандарт спецификации и decision log по продуктовым изменениям.
Вершина пирамиды: главный тезис
Проверка тезиса
- Это прямой ответ на вопрос из SCQA, а не общая формулировка.
- Тезис конкретен и проверяем: можно подтвердить или опровергнуть данными.
- По формулировке тезиса можно понять, какие аргументы должны идти ниже.
Основание пирамиды: аргументы и детали
Обобщение снизу вверх
Каждый уровень текста резюмирует уровень ниже и не повторяет его дословно.
Однородность идей
В одной группе аргументов пункты одного масштаба и одного типа.
Логичный порядок
Хронология, приоритет или системная структура должны быть явными.
MECE-покрытие
Аргументы не пересекаются и вместе покрывают предмет без пробелов.
Готовый каркас для документа
- Situation: что происходит сейчас.
- Complication: что мешает и почему это важно.
- Question: какой ключевой вопрос нужно решить.
- Answer: основной тезис в 1-2 предложениях.
- Аргумент A + факты.
- Аргумент B + факты.
- Аргумент C + факты.
- Риски, ограничения, следующий шаг.
Частые ошибки
Сначала давать детали, а вывод оставлять в конце текста.
Смешивать факты, причины и последствия в одном списке без структуры.
Держать рядом пункты разного уровня абстракции.
Менять логику порядка между абзацами и ломать маршрут чтения.
Что внедрить сразу
- Писать вводную часть по SCQA перед каждым RFC/ADR.
- Ставить главный тезис сразу после введения, не прятать в середину.
- Группировать аргументы по одной логике и явно подписывать разделы.
- В конце документа фиксировать риск, ограничение и следующий шаг.