https://courses.digitable.life/communication-engineering/book/03-writing/ Recent content in Письменная коммуникация on Digitable courses Hugo -- gohugo.io ru-RU https://courses.digitable.life/communication-engineering/book/03-writing/asynchronous-communication/ Mon, 01 Jan 0001 00:00:00 +0000 https://courses.digitable.life/communication-engineering/book/03-writing/asynchronous-communication/ Либо ты планируешь свою жизнь, либо она с тобой случается. Николай Мрочковский — «Экстремальный тайм-менеджмент» Communication Engineering · async Правило Выбирай асинхронный канал, когда ответ не требует общей минуты; собирай контекст так, чтобы человек мог ответить за один проход. Асинхронная коммуникация защищает фокус и позволяет людям работать в разном ритме. Но плохо спроектированный async превращается в бесконечную очередь уведомлений, где решение размазано по десяткам сообщений. Чат Чат подходит для короткого уточнения, оперативного сигнала и координации. https://courses.digitable.life/communication-engineering/book/03-writing/documentation/ Mon, 01 Jan 0001 00:00:00 +0000 https://courses.digitable.life/communication-engineering/book/03-writing/documentation/ Ваша работа — так же страстно защищать код. Роберт Мартин — «Чистый код» Communication Engineering · документация Правило У каждого документа должны быть читатель, рабочая задача, владелец актуальности и сигнал устаревания. Документация — интерфейс к системе и памяти команды. Плохая документация увеличивает зависимость от конкретных людей, заставляет повторять ошибки и превращает онбординг в археологию. Проблема редко решается призывом «документировать больше». Документов становится больше, а найти ответ сложнее. https://courses.digitable.life/communication-engineering/book/03-writing/good-work-text/ Mon, 01 Jan 0001 00:00:00 +0000 https://courses.digitable.life/communication-engineering/book/03-writing/good-work-text/ Деньги по своей природе являются общественным отношением. Виктор Пелевин — «Пространство Фридмана» Communication Engineering · рабочий текст Правило Начинай с того, что меняется для читателя, затем давай контекст и доказательства в порядке потребности. Рабочий текст существует внутри отношения: автору что-то нужно от читателя. Даже справка без явной просьбы должна помочь найти ответ. Поэтому качество текста определяется не красотой фраз, а стоимостью правильного действия после чтения. Сначала контракт Перед написанием ответьте: https://courses.digitable.life/communication-engineering/book/03-writing/rfc-and-adr/ Mon, 01 Jan 0001 00:00:00 +0000 https://courses.digitable.life/communication-engineering/book/03-writing/rfc-and-adr/ Буду больше работать. Джордж Оруэлл — «Скотный двор» Communication Engineering · RFC и ADR Правило RFC открывает решение для влияния до реализации, ADR сохраняет сделанный выбор после обсуждения. RFC и ADR часто смешивают, потому что оба говорят о решениях. Их функции различаются. RFC — запрос на обсуждение значимого изменения. Он создаёт пространство для вопросов, альтернатив и влияния. ADR — запись архитектурного решения. Она сохраняет контекст, выбор и последствия для будущих участников.