Три места для материала
Прошлый урок был про то, что вы просите. Этот — про то, что вы приносите: какой материал, сколько и куда его положить.
Мест для материала три, и различаются они не удобством, а сроком жизни и тем, кто его видит.
| Место | Живёт | Видит |
|---|---|---|
| в сообщении | до конца разговора | вы |
| в проекте | пока проект существует | вы и те, с кем поделились |
| в репозитории | пока не удалят | все, у кого есть доступ |
В сообщение кладут разовое: документ, который разбираете сегодня, письмо, ошибку, кусок таблицы. Задача закончится — материал не понадобится, и держать его дальше незачем.
В проект кладут то, к чему возвращаются: свод правил, справочник терминов, набор примеров «как у нас принято», описание предметной области. Это материал, который вы иначе приносили бы руками каждый раз.
В репозиторий кладут то, что должно пережить вас: правила проекта, процедуры, договорённости. Это уже не «материал для разговора», а часть проекта — и работает она во всех местах сразу, как мы выяснили в первом уроке.
Есть и четвёртое место, о котором стоит знать отдельно: то, что он берёт из проекта сам. В репозитории он не ждёт, пока вы приложите файл, — он ищет по нему, читает найденное и приносит в окно без вашего участия.
Формально это не «место для материала», а способ его добычи, но в списке его держать полезно: именно здесь чаще всего появляется в ответе то, чего вы туда не клали. К этому мы вернёмся в последней главе.
И обратная ошибка, которая встречается реже, но стоит дороже: в проект кладут то, что нужно один раз.
Проект — не хранилище. Всё, что в нём лежит, участвует в каждом разговоре внутри него: занимает окно, влияет на ответы, смешивается с новым материалом. Забытый там документ прошлого квартала через месяц начнёт подмешиваться в чужие задачи — и заметить это будет трудно, потому что ответ останется правдоподобным.
Сколько приносить
Вторая глава — про количество: сколько материала приносить. Крайности две, и одна из них опаснее другой.
Мало — ответ выйдет общим и не про вас. Это неприятно, но безопасно: вы сразу видите, что он отвечает вообще, а не про вашу задачу, и досылаете нужное.
Всё, что есть — ответ выйдет осмысленным и относящимся не к тому. Вот это опасно, потому что не видно: складный ответ про соседний случай выглядит ровно как складный ответ про ваш.
Мерка, которая работает: уберите кусок — изменится ли ответ?
| Что приложили | Что спросить себя |
|---|---|
| три редакции документа | нужны все три или хватит последней? |
| весь отчёт | или достаточно раздела, о котором речь? |
| переписку целиком | или двух писем, где обсуждали именно это? |
| базу примеров | или трёх примеров нужного вида? |
Ответ почти всегда в пользу меньшего, и вот почему: вы прикладываете «на всякий случай», а он честно пытается учесть всё. Человек в такой ситуации спросил бы «а что именно вас интересует»; модель попробует связать всё приложенное в один ответ.
И отдельный случай, который выглядит исключением и им не является: задача, где важен именно объём. Свести сто строк таблицы, пройти по сорока письмам, собрать все упоминания темы в длинном документе — тут материала много по существу, а не «на всякий случай».
Разница видна по одному признаку: вы можете назвать, зачем нужен каждый кусок. Сто строк нужны, потому что сводить надо все сто. Три редакции документа приложены, потому что «вдруг пригодится», — и это уже другой случай. Мерка «уберите кусок» работает и здесь: убрали строку из таблицы — ответ изменится, убрали старую редакцию — нет.
И мелочь, которая экономит больше, чем выглядит: скажите, чем этот материал является. «Это старая редакция», «это черновик, не смотри на оформление», «это пример того, как делать не надо», «это образец правильного отчёта».
Без такой пометки всё приложенное читается как равноценное и одинаково достоверное — в том числе черновик, который вы приложили для сравнения, и пример плохого оформления, приложенный как антипример. Одна фраза при вложении снимает эту путаницу целиком, а стоит она пяти слов.
И приём для случая, когда материала правда много: принесите оглавление, а не содержимое. Список файлов с одной строкой описания, заголовки разделов, перечень таблиц — и вопрос «что из этого нужно посмотреть для такой задачи». Он назовёт два-три места, и вот их вы приложите целиком.
Долгая работа
Третья глава — про долгую работу: ту, что тянется неделями и к которой возвращаешься по частям.
Разговор для неё не место, и причина названа в прошлом уроке: он временный. Закроется вкладка — исчезнет всё, что в нём выяснилось.
Место для долгой работы — файл, и устроен он просто: там лежит то, что выяснено, что решено и что осталось.
| Что в файле | Зачем |
|---|---|
| что уже решено и почему | чтобы не пересматривать по третьему разу |
| что отвергнуто и почему | самое ценное и самое теряемое |
| где остановились | точка входа для следующего захода |
| что осталось выяснить | список, а не ощущение |
Работает это так: заход начинается с того, что вы даёте файл, а заканчивается тем, что дописываете в него итог. Полминуты в конце каждого захода — и работа держится независимо от того, сколько вкладок закрылось между ними.
Есть и вторая выгода, менее очевидная. Файл заставляет формулировать: пока вы пишете «решили делать так, потому что», вы проверяете, действительно ли решили и действительно ли потому. Половина неясностей ловится прямо здесь, до того как стать проблемой.
Формат файла при этом значения не имеет: заметка, документ, страница в вашей системе задач, обычный текстовый файл рядом с проектом. Важно одно — чтобы он лежал там, куда вы вернётесь, и открывался вместе с работой, а не искался по памяти.
Практически это чаще всего файл рядом с самой работой: в папке проекта, в той же задаче, в том же документе. Файл, за которым надо идти в другое место, через неделю перестают вести — не из лени, а потому, что он выпал из дороги.
И честная оговорка: не всякая работа требует файла. Задача на час его не стоит, задача на три дня — уже да. Граница проходит примерно там, где вы второй раз возвращаетесь к задаче после перерыва: если возвращение случилось, значит, случится и третье.
Материал, которого вы не приносили
Последняя глава — про материал, которого вы не приносили, и это самая тонкая часть урока.
Кроме того, что вы дали явно, в ответе участвует то, что он нашёл сам: поиском по проекту, по вложенным файлам, по подключённым источникам. Это удобно и имеет цену.
| Вы принесли | Он нашёл сам |
|---|---|
| знаете, что в окне | не знаете, что в окне |
| знаете, на чём ответ | не знаете, на чём ответ |
| ничего лишнего | лишнее возможно |
| дольше готовить | быстрее спросить |
Практическое правило простое: там, где ответ важен, материал приносят явно. Разбор, от которого зависит решение; текст, который уйдёт наружу; расчёт, на который вы будете ссылаться, — в этих случаях лишняя минута на «вот конкретный файл» окупается.
А там, где вы просто разбираетесь, поиск удобнее и дешевле по вниманию: пусть ищет, а вы спросите, откуда взял, если ответ вас удивит.
И последнее — про чужой материал, потому что тут есть ловушка, о которой не думают.
Текст, попавший в контекст, выглядит одинаково независимо от того, кто его написал. Ваше поручение, содержимое чужого документа, комментарий в задаче, письмо от незнакомого человека — всё это приходит одним потоком.
Стоит назвать и тот случай, где это правило нарушают чаще всего, и почти всегда не задумываясь: «посмотри, что просят в этой задаче, и сделай». Звучит как обычное делегирование, а на деле это передача поручения от неизвестного вам автора: в задачу писал коллега, клиент, внешняя система, и написать там могли что угодно.
Правильный вид той же работы — в два шага: сначала «прочитай и перескажи, что там просят», потом ваше собственное поручение. Второй шаг вы формулируете сами, уже зная содержание. Стоит это лишних двадцать секунд и снимает весь класс неприятностей разом.