2learn

Jira и Confluence

Jira, Confluence

Что это такое

Jira ведёт работу: это элементы с владельцем, статусом и историей в рабочем процессе, который показывает, над чем идёт работа и что застряло. Confluence служит вики — на её страницах хранятся решения, спецификации и материалы для онбординга, а история хранит, кто что менял; вместе они образуют самую распространённую пару для ведения записей в agile-командах: трекер для того, что имеет состояние, вики для того, что имеет содержимое.

Почему это важно

Ценность здесь в том, чтобы нужное можно было найти, и в общем состоянии: тикет несёт обсуждение, решение и ссылку на изменение, поэтому никому не приходится спрашивать, что с ним стало, а решение, записанное на вики-странице, а не в ветке чата, можно найти и через полгода. Однако цена не менее реальна, и о ней стоит сказать прямо: трекер, который предписывает рабочий процесс, перекраивает работу команды. Если на доске одиннадцать колонок только потому, что этого требовали настройки инструмента по умолчанию, значит, процесс проектирует инструмент, а не команда. Честная проверка проста: переживёт ли рабочий процесс замену инструмента.

Ключевые идеи

Трекер — для того, что имеет состояние; вики — для того, что имеет содержимое

Исследовательский отчёт, положенный в тикет, становится ненаходимым; баг, записанный на вики-страницу, — неотслеживаемым. Каждый инструмент используйте для того, на что он похож по форме.

Тикет    баг, история, запрос на изменение, эскалация в поддержку
Страница запись решения, заметка об архитектуре, примечание к релизу,
         runbook, материал для онбординга

Настройте рабочий процесс под реальность, а затем прекратите настраивать

Каждый статус должен означать что-то, по чему человек может действовать, и у каждого статуса должен быть выход. Удаляйте колонку, через которую никто не двигает элементы.

Пишите тикеты для того, кто прочтёт их через полгода

Заголовок называет результат, тело содержит шаги воспроизведения или выгоду, а ссылки ведут на код и на решение. У того, кто прочтёт это позже, сегодняшнего контекста уже не будет.

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

У вики-страницы должен быть владелец и дата ревью

Страницы без владельца устаревают, а им всё равно доверяют — и это хуже, чем их отсутствие. Ставьте имя и дату на каждую страницу, которая утверждает текущий факт.

Говорите, когда процесс формирует инструмент

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

Практика

Проведите аудит одного рабочего процесса

Откройте список статусов вашего трекера и для последних пятидесяти элементов посчитайте, сколько прошло через каждый статус и сколько они там ждали.

Готово, когда: у каждого статуса ненулевое число прошедших или он удалён, и ни один статус не держит элемент дольше недели без причины.

Напишите одну запись решения на вики

Возьмите недавнее решение и напишите страницу с решением, рассмотренными вариантами, свидетельствами и датой, а затем свяжите её с тикетом, на который она повлияла.

Готово, когда: человек, читающий тикет через полгода, доходит до обоснования в один клик.

Частые ошибки

  • Рабочий процесс по умолчанию, принятый за процесс — команда обходит доску, не соответствующую реальности; исправить: удалите статусы, которыми никто не пользуется.
  • Документы, хранимые как тикеты — знание становится ненаходимым; исправить: содержимое — на страницы, состояние — в тикеты.
  • Тикеты без достаточного контекста — читатель через полгода не может действовать; исправить: назовите в заголовке результат и включите шаги, ссылки и окружение.
  • Вики-страницы без владельца — устаревшим фактам доверяют; исправить: имя и дата ревью на каждой странице.
  • Отчёты, построенные ради оправдания инструмента — поля заполняют для дашборда, а не для работы; исправить: решите явно, какая отчётность вам нужна, и перестаньте собирать остальное.

Что читать дальше

Разобранные примеры

Файлы cookie аналитики ставятся только с вашего согласия. До вашего выбора ничего не загружается и никуда не отправляется.