Сначала выберите репозиторий и диапазон дат
Начните с проекта, работу которого хотите обобщить. Выберите поддерживаемый диапазон в один или два дня. Это не позволяет отчёту о репозитории клиента поглотить не связанную с ним работу из другого проекта.
Standup использует записанные успешные попытки выполнения в этом окне. У задачи может быть несколько попыток, поэтому опирайтесь на датированные свидетельства, а не предполагайте, что дата исходного создания задачи описывает время выполнения полезной работы. Отложенным идеям и незавершённым запросам не место в отчёте об уже выполненной работе.
Используйте журнал изменений как черновик, основанный на свидетельствах
Сформированный отчёт группирует доступную работу по разделам Added, Changed, Fixed и Security. Он может отвечать на уточняющие вопросы, используя те же сохранённые свидетельства. Это даёт вам возможность спросить, какая задача подтверждает ту или иную строку или какие файлы, по отчёту, изменило выполнение.
Успешное выполнение задачи ещё не означает выпуск в продакшен. Прежде чем сообщать клиенту о готовой функции, убедитесь, что изменения прошли проверку, слияние и развёртывание в рамках вашего процесса выпуска. Standup фиксирует проделанную работу, а заметки к выпускам показывают, что было опубликовано.
Переводите изменения на язык клиентского сценария использования
Техническая строка вроде «добавлен экспорт CSV с фильтрацией» становится полезной, когда вы объясняете, что теперь может сделать клиент и где это найти. Держите объяснение привязанным к фактическому результату. Если задача лишь улучшила предпросмотр, не представляйте это как новую возможность экспорта.
Используйте один конкретный пример, упоминайте ограничение, если оно влияет на следующий шаг, и давайте ссылку на соответствующее руководство. Избегайте выдуманной экономии времени, цитат клиентов или заявлений о темпах внедрения. Конкретное поведение продукта убедительнее превосходной степени без доказательств.
Сохраняйте привычку проверять сводку
Сверяйте каждую строку с результатом задачи и доступными патчами. Удаляйте внутренние операционные детали, которым не место в клиентском отчёте. Если результат неоднозначен, изучите работу или уберите утверждение.
Статьи о релизах на сайте следуют тому же принципу доказательности на другой границе: они используют опубликованные примечания к релизу и объясняют практический рабочий процесс, стоящий за соответствующими изменениями. Standup помогает собирать свидетельства разработки. Примечания к релизу и редакторская проверка решают, что становится публичным заявлением о продукте.
Изучите Держите работу разработки клиента привязанной к его запросу, Единое рабочее пространство оператора для нескольких клиентских репозиториев.