1. Документирование долгоживущих веб-проектов Глеб Белогорцев РосБизнесКонсалтинг

3. Нужно поддерживать актуальность

6. пишется силами разработчиков

7. время ограниченоНо выводы делаются на основе общих принципов.

8. Определение целей Зачем вообще нужна документация? Какие могут быть цели?

10. Облегчить погружение в проект новых сотрудников

11. Стандартизировать регулярно возникающие задачи по поддержке, распространить знания о них

12. Сохранить знания по технически сложным и неочевидным деталям реализации

15. Определение набора артефактов Пример: диаграмма последовательности Описывает процесс, в котором легко разобраться по коду, или который часто меняется – не нужна. Описывает очень сложный процесс или вы умеете генерировать её автоматически – нужна.

17. Надежность

18. Производительность

19. Возможность поддержки

22. Адреса, телефоны

26. svn log

29. URL SVN

30. URL проекта

31. URL админки

32. закрытые разделы (и как получать доступ)

33. платформа (язык, фреймворк)

36. Поиск

37. Гиперссылки

38. Аттачи

39. Версионность

41. Инструменты Wiki Много функций «из коробки». Нет жесткой структуры, работы с деревьями документов.

42. Инструменты Plain text+SVN (asciidoc, Doxygen, LaTeX) Можно управлять структуройи представлением. Дополнительные фичи нужно дописывать самостоятельно. Неудобно редактировать.

47. Распараллелить работу

48. Поручить новичкам

51. Спасибо за внимание Вопросы? Контакты E-mail: belgleb@gmail.com Блог: http://WidgetOK.ru