Як документуєте інформацію за Agile/Scrum?

Вітаю, ІТ спільното!
Підкажіть, будь ласка, як саме ви документуєте інформацію (опис програми, пояснювальні записки),яка утворюється в результаті ходу проекту за Agile/Scrum, щоб нові розробники/тестувальники чи старі розробники, що повертаються на проект знали про що він взагалі?
За цінностями Agile на документації не робиться акцент, як у вас з цим відбувається?) Які інструменти використовуєте? Як багато взагалі документуєте?

👍ПодобаєтьсяСподобалось0
До обраногоВ обраному0
LinkedIn
Дозволені теги: blockquote, a, pre, code, ul, ol, li, b, i, del.
Ctrl + Enter
Дозволені теги: blockquote, a, pre, code, ul, ol, li, b, i, del.
Ctrl + Enter

знания о проекте в целом проблема независимо от методологии разработки

даже там, где что то пытаются документировать, со временем задокументированное становится малополезным )

тю) відкриваємо аджайл маніфест)

«Працюючий продукт важливіший за вичерпну документацію»

)) якщо що, то це жарт

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

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

жестяк(
блейм полезен, если в коммите указана таска. там и сам коммит можно глянуть что цепляет, и таску поднять чтобы выяснить нафига оно надо

Ну в идеале — вести вики + комменты в коде. Это если следовать подсказкам разума.
Если следовать Скраму — то все программисты (вместе с тестировщиками) в команде взаимозаменяемы, и проблемы с документацией быть не может.

Обычно автогенерация по коду/модулям + люблю работать с гитхабом и использовать местное вики, сам гит и ПР в качестве источника дополнительных знаний.
Есть еще вариант «документации» тестами, когда поведение очень нелогично, но «так надо»

статья на тему документации в коммитах/пр от моего бывшего однокурсника

Підписатись на коментарі