Я регулярно пишу и обновляю техническую документацию, которая будет использоваться для настройки новой виртуальной машины или для поиска системных зависимостей в сетях с примерно 20-50 (серверными) компьютерами. В настоящее время я использую OpenOffice Writer с текстовыми таблицами и создаю один документ для каждого домена интрасети.
Чтобы улучшить эту документацию, я хотел бы собрать несколько примеров, чтобы определить области, в которых мои документы могут быть улучшены в отношении общей структуры и содержания, чтобы упростить чтение и использование не только для меня, но и для технического персонала, службы поддержки и т. Д.
Существуют ли простые текстовые шаблоны (например, для OpenOffice Writer) или инструменты (возможно, управляемые базой данных) для структурированной документации конфигурации компьютера?
Такой шаблон / инструмент должен содержать обязательные и необязательные разделы конфигурации, такие как «операционная система», «установленные службы», «подключенные сетевые диски», «запланированные задачи», «удаленные серверы», «учетная запись пользователя для входа в систему», «настройки брандмауэра». , 'размер жесткого диска' ... В этих документах содержится не столько низкоуровневая документация по аппаратному обеспечению, сколько дополнительная информация об инфраструктуре / интеграции (без настроек BIOS, MAC-адресов).
Может быть, вы могли бы использовать что-то вроде SYDI проект, Открытый аудит или OCSInventory можно ли использовать для создания базовой схемы сети, которую можно экспортировать в OOo Write или Calc, а затем расширить тем, что вам нужно?
Однако у меня нет личного опыта ни с одним из этих проектов. SYDI проект сообщает на своем веб-сайте, что у него есть преобразование из формата XML в OOo Calc, что может быть тем, что вы ищете.