Спочатку оберіть репозиторій і період дат
Почніть із проєкту, роботу якого хочете підсумувати. Оберіть підтримуваний одноденний або дводенний період. Це запобігає тому, щоб оновлення про репозиторій клієнта поглинуло непов’язану роботу з іншого проєкту.
Standup використовує зафіксовані успішні спроби виконання в цьому періоді. Завдання може мати кілька спроб, тому читайте датовані докази, а не покладайтеся на дату створення завдання як на час виконання корисної роботи. Черзі ідеї та незавершені запити не мають місця в оновленні про виконану роботу.
Використовуйте журнал змін як чернетку, обґрунтовану доказами
Створене оновлення групує доступну роботу за категоріями «Додано», «Змінено», «Виправлено» та «Безпека». Воно може відповідати на подальші запитання, використовуючи ті самі збережені докази. Це дає змогу запитати, яке завдання підтверджує рядок або які файли, за повідомленням виконання, було змінено.
Успішне виконання не те саме, що випуск у продакшн. Перш ніж повідомляти клієнту, що функцію випущено, перевірте, чи пройшли зміни рецензування, злиття та розгортання через ваш власний процес випуску. Standup фіксує роботу з розробки; ваші нотатки про випуск визначають історію публікації.
Перекладіть зміни на мову робочого процесу клієнта
Технічний рядок на кшталт «додано фільтрований експорт CSV» стає корисним, коли ви пояснюєте, що тепер може робити клієнт і де це знайти. Тримайте пояснення прив’язаним до фактичного результату. Якщо завдання лише покращило попередній перегляд, не подавайте це як нову можливість експорту.
Використайте один конкретний приклад, згадайте обмеження, якщо воно впливає на наступний крок, і додайте посилання на відповідний посібник. Уникайте вигаданої економії часу, цитат клієнтів чи тверджень про рівень впровадження. Конкретна поведінка продукту переконливіша за безпідставну найвищу оцінку.
Зберігайте звичку перевіряти підсумок
Звіряйте кожен рядок із результатом завдання та доступними патчами. Видаляйте внутрішні операційні деталі, яким не місце в оновленні для клієнта. Якщо результат неоднозначний, перевірте роботу або не включайте твердження.
Статті про випуски на сайті слідують тому самому принципу доказовості на іншому рівні: вони використовують опубліковані нотатки випуску та пояснюють практичний робочий процес відповідних змін. Standup допомагає зібрати докази розробки. Нотатки випуску та редакційна перевірка визначають, що стає публічним твердженням про продукт.
Ознайомтеся зі статтями Тримайте роботу з кодування для клієнта прив’язаною до запиту, Один робочий простір оператора для кількох клієнтських репозиторіїв.