Вам шашечки или ехать: как написать подробную документацию и не потратить на нее все ресурсы проекта

[shchepin]

1. Честно говоря, я трижды перечитал текст, но так и не понял, о каких документаторских артефактах идет речь? Что вы подразумеваете под документацией? Если не пользовательская, то какая?

2. Два "подхода", о которых идет речь в статье, это не подходы, а лишь разные аспекты. Концепция единого источника никак не противоречит инкрементальному подходу в документировании. Это как апельсин сравнить с партитами Баха: оно о.. разном.

3. Если на картинках в кружочках - артефакты документирования, половина из нарисованного - совсем не артефакты документирования.

4. "Задачи в таск-трекере становятся самой актуальной документацией проекта": я понимаю ваше желание забить гвоздик любимым микроскопом, но.. не надо так.

5. Не "функционал" а "функциональность"

[uwriter]

Отвечу по пунктам:

1. Речь о документации вида юзерстори, юзкейсах, ЧТЗ

2. Возможно, вы немного не о том, о чем написано в статье. Инкрементальный подход - это подход, при котором работа над продуктом бьется на инкременты и для каждого инкремента (блока функций) проходится полноценный водопадный процесс: написание полноценной непротиворечивой документации -> разработка -> тестирование
   
   То, что описано в статье это именно подходы к документированию, аспекты в обоих подходах остаются теми же самыми
   
   Документацию можно вести в едином месте и постоянно работать над контролем непротиворечивостью требований ЛИБО просто создавать новые артефакты так, что в них могут быть приняты решения, противоречащие предыдущим артефактам

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

4. Не понимаю вашу логику и не вижу аргументации, почему же нельзя задачи в таск-трекере назвать документацией

5. Не всё так однозначно, как с родом слова кофе :)
   Язык -- живая субстанция и тот факт, что этот термин часто употребляется в нашей среде при общении, в статьях и законах именно в том контексте, в котором я его употребил, говорит о том, что рано или поздно просто все признают, что теперь так тоже правильно