Новые сообщения [новые:0]
Дайджест
Горячие темы
Избранное [новые:0]
Форумы
Пользователи
Статистика
Статистика нагрузки
Мод. лог
Поиск
|
07.09.2009, 13:42
|
|||
---|---|---|---|
|
|||
Чье ремесло писать проект комплектной документации ? |
|||
#18+
Добрый день! Во всех методологиях разработки программного обеспечения существует понятие документация, где "живая" а где "не живая". Довольно часто наблюдаю картину как пара программистов-разработчиков, параллельно написанию кода тщетно пытаются связать слова в более менее ясный документ, именуемый Проектной документацией. Объясните мне, кто по праву и обязанности должен выполнять эту работу? Кто, точнее, специализируется на этом? Кого нужно привлекать к такого рода работам? Большое спасибо! ... |
|||
:
Нравится:
Не нравится:
|
|||
|
08.09.2009, 08:34
|
|||
---|---|---|---|
Чье ремесло писать проект комплектной документации ? |
|||
#18+
Han Yuriy, программист обязан четко и ясно делать комментарии к коду (классы, методы, особенности реализации) можно оформить комментарии для авто-генерации докумендации через doxygen, что будет полезно для составления таких документов как "описание программы" и т.п. никто кроме программиста не напишет содержание руководства оператора к своей программе, оформлять же лучше отдать другому человеку (можно использовать wiki движки для автоматизации) ... |
|||
:
Нравится:
Не нравится:
|
|||
|
08.09.2009, 12:49
|
|||
---|---|---|---|
Чье ремесло писать проект комплектной документации ? |
|||
#18+
Han Yuriy...Объясните мне, кто по праву и обязанности должен выполнять эту работу? Есть такая специальность - технический писатель (разработчик документации). ... |
|||
:
Нравится:
Не нравится:
|
|||
|
08.09.2009, 13:33
|
|||
---|---|---|---|
Чье ремесло писать проект комплектной документации ? |
|||
#18+
ЮВЕсть такая специальность - технический писатель (разработчик документации). Гм .. как исполняющий роль бизнес и системного аналитика по своему направлению пишу 1) Спецификацию на ПО 2) Требования 3) Решения по архитектуре и основные алгоритмы Потом это все отправляется техпису который формирует уже проектную документации. По моему опыту при не типовых решениях решениях или при сильной кастомизации выделенный техпис не способен в приемлимые для проекта сроки описать именно решение. Кроме это написание ключевых моментов доки позволяет еще раз провести трассировку решения. Резюме: внятно-понятное описания ключевых моментов системы бизнес-процесса и построения системы (не вдаваясь в код) лежит на бизнес и системном аналитике (архитекторе) как носителей "гениальных идей" ... |
|||
:
Нравится:
Не нравится:
|
|||
|
08.09.2009, 16:47
|
|||
---|---|---|---|
Чье ремесло писать проект комплектной документации ? |
|||
#18+
shelsoftРезюме: внятно-понятное описания ключевых моментов системы бизнес-процесса и построения системы (не вдаваясь в код) лежит на бизнес и системном аналитике (архитекторе) как носителей "гениальных идей" Да, на стадии технического проекта, когда принимаются основные решения по будущей системе, описать их может только автор этих решений (а техпис оформить, если требуется, в соответствии со стандартами). Но автор письма пишет авторпара программистов-разработчиков, параллельно написанию кода тщетно пытаются связать слова в более менее ясный документ, именуемый Проектной документацией. Т.е.на стадии программирования проект уже есть (хотя бы в голове) и работа по нему ведется. Тогда для чего (для отчетности?) нужно писать документацию на пройденный этап? Или программисты пишут все-таки эксплуатационную документацию? Написать эксплуатационную документацию (особенно на прикладные системы с графическим интерфейсом) техпис должен быть способен. А по эксплуатационной документации, при необходимости, можно написать и проектную (пост фактум). ... |
|||
:
Нравится:
Не нравится:
|
|||
|
|
start [/forum/search_topic.php?author=%D0%B3%D0%B8%D0%B2%D0%B82012&author_mode=last_topics&do_search=1]: |
0ms |
get settings: |
11ms |
get forum list: |
14ms |
get settings: |
10ms |
get forum list: |
15ms |
check forum access: |
4ms |
check topic access: |
4ms |
track hit: |
63ms |
get topic data: |
11ms |
get forum data: |
3ms |
get page messages: |
46ms |
get tp. blocked users: |
1ms |
others: | 725ms |
total: | 907ms |
0 / 0 |