Мало текста – много смысла. Заметки с WAW

Это куда столько букв? Это у меня команда два дня читать будет. А, это для согласования. Ну, понятно.

Каждый раз, когда фиксирую требования, нужно выкрутиться так, чтобы не пострадали ни гибкость разработки, ни здравый смысл, ни целевая аудитория. Основная часть моей целевой аудитории – команда разработки, требования не любит. Видимо, какие-то воспоминания неприятные связаны со словом "требовать" 💁‍♀️

На одном дыхании слушала на WAW "Как писать, чтобы покороче, но со всеми важными деталями" Сергея Нужненко (обзор доклада на сайте конференции). Слушала и кивала, все так, все так. Сказанное спикером хорошо работает для продуктовых команд, не уверена, что применимо везде.

Итак, сначала были ГОСТ и стандарты международных институтов. Потом пришли люди и сказали, что нужно много общаться и не нужно ничего писать. Потом оказалось, что все-таки нужны документы, без них трудно разобраться в легаси и распутывать зависимости. И мы снова пишем.

Читать большие форматы уже некогда, записывать тоже некогда, если нужно внедрить десятки фич за неделю. Среди продуктовых команд есть представление, что аналитик замедляет любую задачу и увеличивает ее объем. Что делать аналитикам? Учиться мало писать.
📍Использовать все способы ничего не писать, если это может сделать кто-то другой, читатель недоступен или не имеет представления о предмете описания. Например, обязательно описать контракт, которым будут пользоваться несколько команд, но не обязательно тратить время на описание внутренней таблицы, которую команда разработки может менять как угодно часто и ей проще посмотреть код.
📍Проверять свои документы на антишаблоны. Форма не должна быть тяжелее содержания, текст не должен быть разорван по смыслу, терминология не должна меняться по ходу документа.
📍Шаблоны опасны, если заполняются формально ради заполнения разделов, которые в конкретной задаче не нужны.
📍Нужно помнить о целевом действии, которое ожидается от читателя, документ должен обеспечивать это действие и отвечать на необходимые вопросы.
📍Структура и наполнение текста должны отражать метамодель системы или функции, то есть показывать уровни системы и надсистем (целей продукта, стейкхолдеров, связанных систем), объекты и действия с ними.

Книги для развития навыков работы с текстом (из доклада):

Д. А. Гусев "Краткий курс логики: искусство правильного мышления"
Б. Минто "Принцип пирамиды Минто"
М. Ильяхов "Пиши, сокращай!", "Ясно, понятно. Как доносить мысли и убеждать людей с помощью слов", "Текст по полочкам. Краткое пособие по деловой переписке"
В. Пропп "Морфология волшебной сказки"
К. Уэйланд "Создание арки персонажа. Секреты сценарного мастерства: единство структуры, сюжета и героя", "Архитектура сюжета. Как создать запоминающуюся историю"

#конференции #инструменты #что_почитать