Як документуєте інформацію за Agile/Scrum?
Вітаю, ІТ спільното!
Підкажіть, будь ласка, як саме ви документуєте інформацію (опис програми, пояснювальні записки),яка утворюється в результаті ходу проекту за Agile/Scrum, щоб нові розробники/тестувальники чи старі розробники, що повертаються на проект знали про що він взагалі?
За цінностями Agile на документації не робиться акцент, як у вас з цим відбувається?) Які інструменти використовуєте? Як багато взагалі документуєте?
10 коментарів
Додати коментар Підписатись на коментаріВідписатись від коментарівзнания о проекте в целом проблема независимо от методологии разработки
даже там, где что то пытаются документировать, со временем задокументированное становится малополезным )
тю) відкриваємо аджайл маніфест)
«Працюючий продукт важливіший за вичерпну документацію»
)) якщо що, то це жарт
Никак. Имеем кучу логики на проекте, о которой никто не знает. Спрашиваю у продакт оунера — отправляет узнавать у коллег. Спрашиваю у коллег, которые на проекте не первый год, — тоже внятно ответить не могут, ибо огромная часть логики была написана до них. Чувствую себя детективом. Стараюсь выяснять вопросы по своим тикетам письменно и иметь всю переписку в комментах в Джире.
git blame же
Увы, проект был перенесен в новый репо в прошлом году, автором кода показывает того коллегу, который переносил. По факту же на проекте поменялось много людей, большинства реальных авторов в нашей команде уже и нету.
жестяк(
блейм полезен, если в коммите указана таска. там и сам коммит можно глянуть что цепляет, и таску поднять чтобы выяснить нафига оно надо
так → так
Коментар порушує правила спільноти і видалений модераторами.
Коментар порушує правила спільноти і видалений модераторами.
Коментар порушує правила спільноти і видалений модераторами.
Ну в идеале — вести вики + комменты в коде. Это если следовать подсказкам разума.
Если следовать Скраму — то все программисты (вместе с тестировщиками) в команде взаимозаменяемы, и проблемы с документацией быть не может.
Обычно автогенерация по коду/модулям + люблю работать с гитхабом и использовать местное вики, сам гит и ПР в качестве источника дополнительных знаний.
Есть еще вариант «документации» тестами, когда поведение очень нелогично, но «так надо»
статья на тему документации в коммитах/пр от моего бывшего однокурсника