@IvanN777

В чем лучше составлять тех документацию для работающего проекта?

Так получилось, что меня назначили старшим, на умирающий проект, засраный в хлам.
По которому и документации то нет и тестами не пахло.
Я хочу начать вести документацию в особенности по процессам.
Так-как надо понимать что-как работает и чтобы это видела команда.
И для написания тестов и рефакторинга она пригодится.
Я уже смотрел некоторый обзор документаций.
Но так-как тут люди весьма интересные, решил посоветоватся.
Хочется найти что-то неочень сложное для освоения, чтобы это не отняло много времени.
Если кто-то, что-то подобное делал, буду рад узнать.
  • Вопрос задан
  • 234 просмотра
Пригласить эксперта
Ответы на вопрос 6
eduardtibet
@eduardtibet
Technical Writer / Documentation Engineer
IvanN777 , чтобы привести свои мысли в порядок, начните с этого ответа: Как лучше сделать документацию компании?
Ответ написан
2ord
@2ord
продвинутый чайник
У нас в команде используется DokuWiki. Есть поиск по документации, история прежних правок и т.д. Удобнее чем Word.
Установка в Ubuntu/Debian Linux проста, через штатный менеджер.
Касаемо документации стоит составить карту различных частей проекта и выставить ссылки на них в иерархии. Можно прикрепить изображения различных диаграмм, ссылки на внешние ресурсы и т.д. Также удобно ссылаться на какие-то внутренние системы, допустим JIRA: [[jira>issue-12345]]
В DokuWiki используются пространства:имён для ведения иерархии.
Ответ написан
402d
@402d
Программирую с 1989 года
в коде добавляешь комментарии и в IDE начинает появляться подсказки , а также можно сгенерировать html документацию
https://www.phpdoc.org/
https://github.com/phpDocumentor/phpDocumentor2
Ответ написан
@LuchS-lynx
инженер-ПТО
Я бы смотрел в сторону wiki движков. На мой взгляд самые функциональные, с учётом плагинов, это mediawiki, dokuwiki, twiki, xwiki, confluence. На мой взгляд последние 2 имеют более дружелюбный интерфейс для юзера.
Ответ написан
@karminski
Разработчик CRM/ERP систем
Microsoft Word, Google Docs
Ответ написан
Ваш ответ на вопрос

Войдите, чтобы написать ответ

Войти через TM ID
Похожие вопросы
НТЦ ПРОТЕЙ Санкт-Петербург
от 40 000 до 60 000 руб.
CSBI Санкт-Петербург
от 60 000 до 80 000 руб.
15 авг. 2018, в 01:47
30000 руб./за проект
15 авг. 2018, в 01:09
70000 руб./в месяц
14 авг. 2018, в 22:43
350 руб./за проект