Документирование разработок

[member]

Внедряем Аксапту с помощью внедренцев, своего опыта в ней мало. Какую документацию на выполненные внедренцами работы и в каком виде необходимо получить от них для дальнейшей поддержки системы ? Прошу совета от имеющих опыт поддержки.

[mazzy]

Не ответ:
Но думаю вам будет интересно
Вы документируете свои модификации?

По сути:
документирование надо вести теми средствами, которые доступны клиенту.
в общем случае word + встроенная в Аксапту справка.
иногда становится совсем невмоготу и подключаем Visio.

Это документирование системы.
Документирование процессов дело еще более загадочное.
Мне лично понравился onTarget. Но у клиентов его нет. Поэтому используем от Visio до PowerPoint'а.

Главное, чтобы клиент мог прочитать подготовленные нами файлы и работоать с ними самостоятельно

[member]

Спасибо, посмотрел.
Уточняю вопрос: Как надо документировать для Заказчика изменения, внесенные в стандартную Аксапту?

[bobkov_imported]

Цитата:

Сообщение от Vladimir_M

Уточняю вопрос: Как надо документировать для Заказчика изменения, внесенные в стандартную Аксапту?

А зачем их документировать? Как вы собираетесь использовать эту документацию для сопровождения? Изменения обычно и так на отдельном слое лежат, их можно рассмотреть при желании...

А если вернуться к исходному вопросу, больше всего полезно для сопровождения руководство пользователя, которое содержит:
1. Модель бизнес-процессов (с ролями, документами)
2. Детальное описание выполнения пользователями автоматизируемых функций в бизнес-приложениях (Аксапта, Excel и так далее).
3. Информационные модели, особенно OLAPы всякие...

Только дорого это - написать такое руководство... Его же потом еще и актуализировать нужно будет в процессе сопровождения системы...

[member]

Цитата:

Сообщение от bobkov

Цитата:

Сообщение от Vladimir_M

Уточняю вопрос: Как надо документировать для Заказчика изменения, внесенные в стандартную Аксапту?

А зачем их документировать? Как вы собираетесь использовать эту документацию для сопровождения? Изменения обычно и так на отдельном слое лежат, их можно рассмотреть при желании...

Т.е. в Аксапте можно легко разобраться в коде, написанном другим программистом и он не требует какого-либо описания?

[Arahnid]

У нас было так (+ мое очень субъективное мнение):
0. Описание бизнес-процессов, но довольно скупое и реализованное не полностью. Даже по мелочам не все реализовали.
1. Нам написали ТЗ. Очень плохое, поскольку тогда писали его пользователи совместно с внедренцами и те схалтурили, а бухи не зная программы и работая с 1с не подзревали, что какие - то вещи не являются обязательными для программ (они считали естественным такой отчет, такой отчет и т.п.).
2. Написали инструкции для пользователей. Тяжело согласовывали. До сих пор не можем утвердить. ВНедренцы жадные на информацию. Во многом - инструкцим копировали из стандартных инструкций Аксапты.
3. Описание проектных решений: перекопированные справочники и настройки в ворде, по одному - пяти предложениям на измененные отчеты, документы и список измененных объектов без комментариевм (классы, таблицы, отчеты, формы). Т.е. понять зачем менялся объект не возможно. Совершенно не понятно зачем это пишут. Бесталково. Ведь будучи админом, я многие настройки, связанные с учетными данными, изменила.

[bobkov_imported]

Цитата:

Сообщение от Vladimir_M

Т.е. в Аксапте можно легко разобраться в коде, написанном другим программистом и он не требует какого-либо описания?

Это изначально зависит от личности программиста. Кто-то пишет понятно, кто-то - так, что проще выбросить чем разобраться. Также это зависит от методики программирования. Для того чтобы улучшить понимание собственно кода, нужно управлять процессом реализации изменений в Аксапте - заставлять программистов использовать определенные приемы программирования, правила именования объектов, переменных, методов, правила комментирования кода и т. д.