Кто должен составлять документацию ( в компании) на программный продукт?

Question

[Pavel89]

Кто должен составлять документацию ( в компании) на программный продукт?
Какой персонал должен этим заниматься?

Answer 1

[Эдуард Тибет]

В принципе, коллеги выше уже основную часть сказали. Добавлю от себя:
1. Концепт системы и ТЗ - Аналитик.
2. Планы работы и контроль их выполнения - ПМ
3. Эксплутационная документация (руководства разного типа и вида, FAQ, HOWTO и т.п.) - технический писатель.
4. API, SDK reference, архитектурные документы - либо технический писатель (если он высокого класса), либо разработчики.
5. Постановка работ по документированию (типы документов, исполнители, docflow между членами команды и.т.п.) - в больших компаниях технический писатель уровня Lead. В маленьких стартапах - у кого больше опыта.
6. Тест-планы, тест-кейсы - группы тестирования (либо лид, либо наиболее опытный)

Для справки предыдущих участником треда: заказчики в 98% случаев НИЧЕГО не делают. Это правда жизни. Т.е. они скажут "хочу это и это", но построить из этих слов грамотную систему - см. п.1

Comments

[sim3x]

Для справки - хотелки пользователя есть база для написания всего, потому они являются базой всей документации

[Эдуард Тибет]

sim3x: Неверный ответ. Хотелки пользователя - материал для написания только того, что входит в п.1 (см. мой ответ). В этот момент они могут быть: изменены, доработаны, полностью отменены, как нереализуемые. Все, начиная с п.2 до п.6 - создается внутри компании, поэтому хотелки пользователя не являются базой все документации.

Answer 2

[Сергей Протько]

Вся команда. Каждый свою часть.

Answer 3

[sim3x]

Заказчик
Технический писатель
ПМ
ТЛ
Поддержка
Разработчики

Answer 4

[Rou1997]

Те же люди, с той же иерархией контроля качества.

Answer 5

[murlogen]

Вопрос смысла не имеет без конкретизации.

Зависит от возможностей компании и сложности продукта и важности документации.

• Иногда - разработчик.
  
• Иногда - специальный технический писатель.
  
• Иногда - никто (или одна страничка в хелпе приложения).