Документация в системе АГБИС

Документация - крайне необходимая вещь в условиях наличия большого количества процессов, схем действий, и вообще вала информации обо всем. В общем это как раз то, что нам очень нужно .
Проще один раз записать, чем рассказывать устно многократно.
Каждый сотрудник должен подумать, если он отвечает на какой-то вопрос, будет ли этот ответ полезен в дальнейшем. Если будет полезен - лучше записать этот вопрос и этот ответ. Если действовать по такому принципу, то со временем накопится именно то, что называется Базой знаний.

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

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

Разделы и подразделы документации проекта, базовая структура: Общая информация Подразделы:

__Цель проекта__ - кратко описываем зачем проект вообще нужен и какие задачи клиента решает. Здесь же можно описать преимущества и почему клиент должен выбрать именно наше решение.
__Текущий статус__ - проект запущен или нет
__Роли в проекте__ - сотрудники компании и какие задачи по проекту они выполняют
__Миссия проекта__ - более полное описание принципов проекта и его решений
__Цены__ - базовые принципы ценообразования, цены или ссылки на коммерческие предложения

Запуск и сопровождение

Руководство администратора - инструкции по настройке модуля
Руководство разработчика - список задействованных программных модулей и описание механизмов доступа к данным.

Руководство пользователя - документация, которая помогает пользователю выполнить бизнес процесс в рамках настроенной системы.
Руководство администратора - документация, которая помогает администратору системы выполнить настройку системы.
Руководство технической поддержки - документация, которая доступна сотрудникам технической поддержки компании АГБИС, но недоступна администраторам клиентов.
Руководство разработчика - документация, которая помогает разработчику дорабатывать систему.

Текст документа справки может хранится:

• на сайте https://www.agbis.ru/laundry/school/
• на сайте https://doc.agb.is/
• в тексте программного модуля,
  
• в текстовом файле - в случае различия документа для разных клиентов.
• Ссылки на курсы документации в Б24
  

Документация может быть связана:

• с отдельной формой - в этом случае ее удобно использовать в виде контекстно зависимой справки назначенной на кнопку Помощь,
  
• с отдельным программным модулем - в этом случае ее удобно подключать через пункт Документация в главном меню программы,
  
• с процессом, который затрагивает несколько модулей - в этом случае документация может хранится отдельно от программных модулей на корпоративном сайте или привязываться к ключевым программным модулям.
  

Стандартный механизм подключения контекстно зависимой справки назначенной на кнопку **Помощь** или к пункту **Документация**

Синтаксис Wiki
Как создавать страницы, права доступа
Изменения в документации