Pragmatic approach to documenting Web projects. Talk at RIT conference, April 2010. Речь идет о документировании процесса разработки Веб-систем. В работе над проектом как правило участвует команда, состоящая из специалистов разных областей: инвесторы, владельцы бизнеса, бизнес-менеджеры, аналитики, разработчики, юзабилисты, дизайнеры, тестировщики, системные администраторы. Эти специалисты обладают разным опытом, имеют разные цели и говорят на разных языках (причем часто – в прямом смысле этого слова). Некоторые роли могут отсутствовать, другие роли могут «склеиваться». Существует достаточно развитая культура документирования проектов, которая включает как традиционные артефакты: видение (vision), бизнес-требования (BRD), функциональные требования (FRD), требования к интерфейсу, технические и архитектурные требования (TAD), требования к тестированию, требования к инфраструктуре, так и аджайльные артефакты: пользовательские истории (user stories), визуальные истории (visual stories). Все Веб-проекты разные: интерфейсные проекты и проекты со сложной логикой (финансовые, научные), средние по размеру проекты и крупные проекты, проекты, которые пишутся с нуля и унаследованные от других разработчиков. Кроме того заказчики могут предъявлять разные требования к документированию: кому-то достаточен список характеристик, кто-то требует детальные функциональные требования, кто-то готов «идти в Agile». Команды тоже бывают разные: полные (свои аналитики, дизайнеры и т.д), локальные и распределенные. В докладе не предлагается один рецепт на все случаи жизни. Главная идея доклада состоит в том, чтобы в соответствии с особенностями проекта и проектной команды рациональным образом выбрать тот набор документов, который абсолютно необходим для его успешного развития.

1. Прагматичный подход к документированию Веб-проектов Анатолий Филин Грамант

3. Откуда ноги растут? Научные библиотеки для российского суперкомпьютера Векторный Фортран, векторный ассемблер . Несколько человеко-лет Трейдинговые системы. IT отдел корпорации. С, С++, Perl5. 3-10 человеко- лет Система онлайновой рекламы. Изначально - старт-ап. ColdFusion, Java. 50-100 человеко-лет Заказные проекты. Java , PHP, Grails. 5 –20 человеко-месяцев

4. Набор документов = F( команда , проект ) Процесс разработки ?

5. Роли и документы Концепция системы Бизнес- требования Требования к архитектуре или Список фич Функциональные требования Макеты экранов Риски Требования к инфраструктуре Тест-план Бизнес-план

8. Роли и документы Бизнес-требования Функциональные требования Системный аналитик Видение, Бизнес-требования Бизнес-аналитик Концепция Бизнес-требования или набор фич Функциональные требования, Макеты экранов Заказчик ( Business owner) Бизнес-план Концепция системы Бизнес-требования Инвестор

9. Роли и документы 2 Функциональные требования Требования к инфраструктуре Системный администратор Бизнес-требования Макеты экранов Проектировщик интерфейсов Функциональные требования Требования к тестированию Тестировщик Функциональные требования технические требования Разработчик

12. Проект: глубина vs ширина

13. Проект: глубина - ширина - размер

14. Команда: география Инвестор Разработчики Заказчик PM Дизайнер

20. А что если Agile ? stories итерации Текущий срез системы

22. Вопросы ? [email_address] http://www.gramant.ru