§3.06 Семейства документов
Время: 45 мин чтение + 30 мин
В одном предложении: Человек думает, что каждый документ уникален и требует уникальной структуры, а на самом деле большинство документов в одной области оказываются родственниками, и без семейств с общими шаблонами каждый новый документ начинается с пустой страницы, а значит с лишних усилий, ошибок формата и хаоса навигации.
Мем, который снимается. «Каждый документ особый случай. Шаблоны ограничивают творчество. Я лучше напишу так, как нужно сейчас, а потом придумаю структуру.» На самом деле «так, как нужно сейчас» обычно означает «так, как получилось под давлением дедлайна». Без шаблона документ рождается хаотично: однажды отчёт начинается с выводов, другой раз с процесса, третий раз с контекста. Читатель теряется, потому что не знает, где что искать. Семейство документов не ограничивает творчество, а освобождает: когда форма задана, мышление освобождается для содержания.
Понятия. Семейство документов — это группа родственных артефактов с общей структурой, критериями приёмки и местом в Pack. Каждое семейство определяется назначением (зачем создаются документы этого семейства), структурой (какие разделы обязательны, какие опциональны), критериями приёмки (по каким признакам документ считается завершённым), примерами (образцы для подражания), местом в Pack (где хранятся шаблон и примеры). Примеры семейств: отчёты о сессиях, рабочие продукты, протоколы встреч, планы недели. Шаблон задаёт форму, которая определяет структуру без диктования содержания. Критерии приёмки защищают от «написал что-то и сдал». Место в Pack защищает от «я помню, где шаблон".
Объяснение. Семейства документов решают три проблемы. Первая: дублирование форматов. Когда каждый создаёт свой формат, через год в организации пять разных шаблонов отчёта, и каждый уверен, что его шаблон правильный. Вторая: затраты на создание. Документ с пустой страницы требует энергии на структуру, прежде чем вы напишете содержание. Шаблон убирает эту затрату: вы начинаете с заполнения, а не с изобретения. Третья: навигация. Когда документы одного семейства имеют общую структуру, читатель знает, где искать нужное. Отчёт о сессии всегда начинается с контекста, всегда содержит выводы, всегда заканчивается следующими шагами. Читатель не тратит энергию на разбор структуры. Семейства не запрещают вариации. Внутри семейства могут быть подсемейства: «отчёт о стратегической сессии» и «отчёт о рабочей сессии» относятся к разным подсемействам с разной детализацией, но общим каркасом.
На практике. Практика «Инвентаризация семейств» (30 мин):
- Перечислите все типы документов, которые вы создаёте регулярно. (5 мин)
- Сгруппируйте их в семейства: какие имеют общую структуру или назначение? (10 мин)
- Для одного семейства создайте или обновите шаблон: обязательные разделы, критерии приёмки, пример. (15 мин)
Типичный кейс. Менеджер сорока лет работал с пятью типами документов: планы недели, отчёты о встречах, спецификации задач, ретроспективы, описания процессов. Каждый раз он начинал с пустой страницы и тратил по двадцать минут на структуру. Инвентаризация показала: планы недели и ретроспективы относятся к одному семейству «периодический обзор», отчёты о встречах образуют другое семейство «протокол события», спецификации и описания относятся к третьему семейству «документирование процесса». Он создал три шаблона. Создание плана недели сократилось с сорока до пятнадцати минут, потому что структура была готова. Читатели отмечали, что его документы стали «легче читать, потому что всегда знаешь, где что искать».
Типичная ошибка. «Шаблоны считаются бюрократией. У нас agile, мы не пишем шаблоны.» Agile не означает отсутствие структуры, а означает адаптивную структуру. Если вы каждый раз изобретаете форму, вы тратите энергию на то, что не добавляет ценности. Другая ошибка: «У меня всего два типа документов, мне не нужны семейства.» Два типа уже образуют начало. Создайте шаблон для каждого. Когда типов станет десять, вы будете благодарны себе за фундамент.
Степени мастерства:
- Объяснение. Могу объяснить, зачем нужны семейства документов, и привести два примера. Критерий перехода: провёл инвентаризацию своих документов.
- Умение. Для каждого нового типа документа определяю, к какому семейству он относится, и использую шаблон. Критерий перехода: десять документов созданы по шаблону.
- Навык. Системно поддерживаю семейства: обновляю шаблоны, устраняю дублирование форматов. Критерий перехода: коллега использовала ваш шаблон для своего документа.
- Мастерство. Проектирую систему семейств для новой предметной области: определяю семейства, шаблоны, критерии приёмки, место в Pack. Критерий перехода: другой человек создал документ по вашей системе семейств без вашей помощи.
Проверка себя.
- Могу назвать три семейства документов, которые я использую, и показать их шаблоны
- Новый документ я создаю по шаблону, а не с пустой страницы
- Проверял свои документы на дублирование форматов за последние три месяца
- Коллега может найти мои шаблоны в Pack без моей помощи
- Могу объяснить, чем одно семейство отличается от другого, за одну минуту
На практике. Возьмите документ, который вы создавали на этой неделе. Задайте вопрос: «Если бы я создавал такой же документ через месяц, начинал бы я с пустой страницы?» Если да, создайте шаблон. Это сэкономит вам время в следующий раз.
См. также: Структура Pack (PD.GUIDE.3.S3.SS3), Рабочие продукты (PD.GUIDE.3.S4).
Что дальше. Следующий подраздел посвящён архитектурным решениям и их фиксации: как записывать важные решения, чтобы не обсуждать их заново.