Назад | Перейти на главную страницу

Я собираюсь создать библию сайта или документацию по нашему веб-серверу?

Я создаю это в ms word, чтобы создать связыватель с тремя кольцами с вкладками, полный документации обо всем о нашем веб-сервере.

Какие основные категории мне следует включить?

У нас есть 2 сервера, оба окна, 1 для Интернета, 1 для sql-сервера, 1 для веб, работает iis7 и coldfusion.

У меня нет подготовки системного администратора, я просто научился. Например, я бы предпочел иметь больше информации, чем никакой информации, например, когда мы только что перенесли наши серверы, и мы пропустили массу вещей, потому что не было документации.

Итак, я хочу хорошо поработать? Я бы не возражал против этого как вики, но мой начальник и коллеги не очень хорошо знакомы с вики и как их использовать. Я, как правило, анальный в нашей группе, хочу расставить все точки над i и все задокументировать.

Какие-либо предложения?

В какой-то степени то, что вы включите, будет во многом зависеть от ВОЗ вы документируете. Вы ведете документацию для администраторов? Для пользователей? Для программистов? Все вышеперечисленное? Так же, как при разработке сайта, вам нужно рассмотреть варианты использования и решить их.

Что я считаю критически важным для документации, предоставленной мне как программисту и / или системному администратору:

  • как создаются резервные копии
  • как следует восстанавливать резервные копии
  • как настроить сайт с нуля (необходимое ПО, процесс установки, настройки и т. д.)
  • список зависимостей (нужен CF, SQL Server, нужен x)
  • документация по любому используемому API
  • оригиналы документов с требованиями, документы изменений (если они есть)
  • информация о том, как создать / использовать администрирование
  • процесс изменения доступа при выходе пользователя (отменить доступ пользователя, изменить общие пароли и т. д.)
  • любые индивидуальные настройки пользователя / клиента / процесса
  • любые "ошибки"
  • любая существующая документация для пользователей
  • запланированные задачи и их расписания
  • процессы, которые необходимо запускать регулярно (обновление индекса, дефрагментация и т. д.) в рамках обслуживания

Если вы создаете электронный источник, например вики, было бы неплохо иметь:

  • оригинальные композиции и мокапы
  • источники изображений
  • прошить файлы .fla
  • ссылки с существующего сайта на документы требований / изменений
  • текущая копия кода выпуска с датой / версией / и т. д. обновляется с каждым основным выпуском или по расписанию (например, ежемесячно).

Используйте OneNote для документации вместо Word

  • Несколько пользователей могут использовать его одновременно
  • При желании экспортировать в pdf
  • щелчок правой кнопкой мыши «отправить в onenote» повысил ценность нашей документации.
  • отслеживание правок

Это лишь некоторые из особенностей. Для нас на самом деле существует слишком много преимуществ, чтобы перечислять их.