12.08.2022

Отчёт о выполненной работе

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

В общих чертах отчёт должен быть таким, чтобы клиент только прочитав его уже на 99% был уверен что задача выполнена.

Как этого добиться? Рекомендации:
В начале отчёта процитировать задачу. Если задача состоит из подзадач, подпунктов, которые могут быть рассмотрены отдельно друг от друга, то цитируется каждая такая подзадача и под каждой краткий отчёт по ней.
Результат выполнения можно подтвердить 1-2 скриншотами и кратким описанием, если оно требуется для пояснения.

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

Для этого хорошо подходит приложение Яндекс.Диска, в которое встроен скриншотер. Вы можете установить и присоединить его  к рабочему аккаунту, чтобы отделить рабочие скрины от личных данных на ПК.

На скриншоты должен попадать результат работы, адресная строка браузера, элементы навигации админки — в общем всё что позволит клиенту взглянув только на ваш снимок экрана моментально сообразить где он сам может это найти и проверить.
Бывает часть работы не имеет какого-то визуально значимого результат для клиента, тогда можно показать какие-то косвенные изменения, или описать словами что было сделано по задаче.

Например, вы оптимизировали какой-то код. Если скинуть скрины до и после — для клиента это будет не понятно, клиент, как правило не программист. В таком случае можно парой фраз описать что было сделано и зачем, и, например если это повлияло на показатель скорости сайта в админке, приложить скрины по скорости до и после.

Бывает, что за день задача не решается, в таком случае следует в комментарии оставить промежуточный отчёт для себя и коллег, что было сделано по задаче за день, и какой следующий шаг. Детализация должна быть такой, чтобы если эта задача внезапно отложилась на неделю-другую, то по данному комментарию вы могли бы вспомнить её и не начинать все с нуля. Или чтобы ваш коллега которому передали эту задачу, так же мог понять что уже сделано, проверено, и откуда ему следует продолжать.