В нашей компании 8 отделов, в каждом из которых в среднем около 12 человек. Я технический директор компании, а ИТ-службы задействованы практически во всех отделах. Таким образом, необходимо определить и задокументировать все ИТ-процессы, а также все сценарии технического уровня, чтобы мы понимали, что мы делаем. Могут быть такие вещи, как:
И так далее, список только растет ...
Визуальное документирование этого с использованием какой-то стандартной методологии является требованием, поскольку множество текстов просто вводит слишком много накладных расходов с точки зрения быстрого понимания. Любой такой инструмент должен быть простым и быстрым в использовании, иначе документация НЕ появится.
Что вы там используете? Любой вклад приветствуется.
Практически для любой функциональной диаграммы я использую диа. Это не самая лучшая программа для рисования в истории мира, но она работает достаточно хорошо, и ее можно установить в Windows и MacOS, а также в Linux. очень удобно во всех средах, в которых я работаю.
Я использовал его для создания действительно довольно сложных сетевых диаграмм, и возможность отправлять их людям для просмотра, не беспокоясь о том, на какой платформе они работают, действительно очень удобно.
Я предпочитаю Visio. Это хороший момент, когда вам нужно убедиться, что все, что вы выберете, вы отправляете в удобном формате.
Если у вас еще нет вики, я бы порекомендовал что-то вроде слияния, а затем аддон вроде http://www.gliffy.com/. Или вы могли бы просто использовать http://www.gliffy.com/ автономный.
Похоже, что более серьезный вопрос касается самих диаграмм. Для этого я думаю, что лучший подход - начать с поиска каких-то блок-схем или диаграмм процессов, которые вам нравятся, и подражать им. Все зависит от того, что вы документируете.
Confluence Wiki и плагин Gliffy
Действительно здорово, так как это означает, что вы делаете все, что касается документации, в одном месте.
Раньше я использовал Dia, и он работает довольно хорошо. Мне нравится иметь что-то, что я могу использовать на своем Linux-компьютере. ;)
Но лучше всего Visio, добавленные функции, такие как связывание базы данных SQL, совместное использование вашей схемы через Интернет.
Стоит денег, и, будучи техническим директором вашей организации, рассмотрите возможность получения подписки Technet, тогда вы сможете получить Visio за небольшую плату.