Давайте обсуждать 👌🏻

КАК НАЙТИ ВОЛШЕБНЫЙ УРОВЕНЬ "ДОСТАТОЧНОСТИ" ДОКУМЕНТАЦИИ, ЧТОБЫ И РАЗРАБОТЧИКОВ НЕ ОБИДЕТЬ СВОИМ ВМЕШАТЕЛЬСТВОМ, И ТРЕБОВАНИЯ ДОНЕСТИ?

Достаточность - понятие относительное и все зависит от вашей команды, потому что кому-то надо детально объяснять, а кому-то достаточно в курилке накидать на пальцах
Критерии на которые можно ориентироваться:
🔘 Ваш уровень нормы
Как вы привыкли и как вы понимаете, что для вас это достаточно или недостаточно
🔘 Уровень каждого члена команды
Это синьоры, это мидлы или джуны и в зависимости от этого там тоже надо либо разжевывать, либо верхнеуровнево описывать
🔘 Слаженность команды
Если в команде все уже давно работают и понимают друг друга с полуслова - это одно, а если это новая команда, то придется постараться и дать больше деталей
Это если говорить про достаточность с точки зрения "а понятно ли команде, что делать"
➖➖➖
Если говорить про достаточность с точки зрения наполнения, то:
БАЗОВО вы должны понимать, какие артефакты у вас должны быть при постановке
Например, что должно быть:
- в исследовании,
- в постановке на FRONT,
- в постановке на BACK,
- в постановке на API,
- в постановке на БД
и что там должно быть обязательно, а что опционально
Например, шаблоном, что я собираю для исследования делился здесь, а что должно быть в постановках на API и FRONT - делюсь у себя на курсе по интеграциям
Дальше, заполняете этот документ, который вам нужно представить команде, основными данными и на груминге уже валидируете с командой его

А что делать, когда в ответ тишина и все на груминге молчат?

Сразу скажу, что вы не одиноки и у меня такое тоже случается и ощущаешь себя, как попугай, в этот момент, который одно и тоже повторяет и в ответ тишина
Так получается, потому что каждый думает "ну сейчас кто-то другой скажет свое мнение и поедем дальше"
И я стал практиковать такой подход, если возникает тишина в ответ на мой спич
🔘 Обращаюсь по имени к конкретному человеку в команде
🔘 Точечно с каждым выясняю:
- все ли ок?
- есть ли вопросы?
- дополнения?
Это мне помогает и решения мои валидировать с командой и вовлечь ее в процесс обсуждения 😉

1
Начать дискуссию