Communication Engineering Письменная коммуникация
0%
Communication Engineering

Письменная коммуникация

Рабочие тексты, документация, RFC, ADR, почта, чаты и code review.

Совершенствоваться — значит меняться.
Роб Коул — «Блистательный Agile»
Сырые заметки превращаются в структурированный документ с решением и историей изменений.
Communication Engineering · письмо

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

Сильный рабочий текст не обязан быть литературным. Он должен помогать действию: быстро показать ставку, отделить факты от выводов, сохранить причины и дать читателю понятный маршрут.

Главы

Результат раздела

Читатель сможет выбирать размер и формат текста под решение, строить информационную иерархию, писать документы с жизненным циклом и уменьшать стоимость повторного восстановления контекста.

Археология

Найди рабочее решение месячной давности и попробуй восстановить его причины только по письменным артефактам. Запиши, какой информации не хватает и где она должна была жить.

  • Чаты, почта и code review

    Как выбирать асинхронный канал, снижать дробление контекста и писать полезные комментарии к коду.

  • Документация

    Как проектировать документацию как продукт с аудиторией, владельцем и жизненным циклом.

  • Хороший рабочий текст

    Как строить сообщения и документы вокруг цели, читателя и следующего действия.

  • RFC и ADR

    Как обсуждать изменения до реализации и сохранять причины принятых архитектурных решений.

Нашли неточность? Выделите фрагмент текста — рядом появится жучок.

Нужен разбор именно вашей ситуации?

Статья описывает общий случай. Если у вас частный — можно разобрать его отдельно, платно. А если не хватает целого материала, предложите тему: её оплачивают вскладчину, и она выходит открытой для всех.

Доска запросов
Дальше