реализация справки в навижине по внедряемому или модифицированному функционалу

[Uni_DeMoN_imported]

subj
как кто сделал систему ведения справочной или проектной документации по некоторому новому или модифицируемому функционалу в навижен понятно что для модификаций существует соотв. раздел Documentation.
Это для разработчиков.
Но если в конторе постоянная текучесть кадров или внедряется новые фишки в системе обьяснять каждый раз это всем сотрудникам. проводить учебные курсы утомляет, обьяснять почему тут ети цифирки невкуриваюшему начальнику какого-то отдела, а не другие каждый раз надоедает.
Выход один: сопроводительная документация к каждому вызывающему сложность для работников прогрммному функционалу(форма, отчёт).

Вопрос: как у кого это реализовано.
В свою очередь мне кажется ,что наиболее грамотно сделать по-типу внутренней справки для каждого модуля. Кто что думает по этому поводу

[mazzy]

портал, сайт, форум. что-то из этой области.
портал, кстати, полезен сам по себе...

[komar]

Два варианта - база знаний или просто вордовый файл.

[mazzy]

вордовый файл неудобно править, если над ним работает группа.
кроме того, если между разными вордовыми файлами непросто ставить гиперссылки (закладкам учить надо).
но можно и вордовый...

[Uni_DeMoN_imported]

Цитата:

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

портал, сайт, форум. что-то из этой области.
портал, кстати, полезен сам по себе...

Mazzy я пока не так глобально хочу. Для начала думаю поможет элементарный help (было бы просто замечательно перехватывать нажатие f1 навижен и вытаскивать нужный раздел из инсталируемого файла справки по данному модулю).
Это бы значительно сократило время натаскивания сотрудников для работы с текущим и модифицируемым функционалом.
Но как это связать, чтобы и работало и было удобно править самфайл справки, и обновлять его на клиентских машинах.

[Dzemon]

А вот про это не думали?

Заметки Фирмы
В системе Microsoft Navision Attain реализована специальная функция, называемая Заметки фирмы. Она позволяет дополнять и дописывать отдельные разделы Справки, включая в них информацию, касающуюся конкретной фирмы или организации.

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

Функция Заметки фирмы может служить нескольким целям. Подобная заметка может разъяснять политику фирмы в отношении функции, описанной в разделе Справки. Заметка может объяснять характерные для фирмы специфические процедуры пошагового исполнения задач, связанных с разделом Справки. Заметки, в конце концов, могут просто перечислять подсказки и хитрости в применении функции, описанной в разделах Справки.

Примечание
Заметки фирмы могут быть распечатаны вместе с соответствующим разделом Справки. Однако при печати целой книги, состоящей из разделов Справки, заметки фирмы не будут выведены на печать.

[mazzy]

[quote=Uni_DeMoN]

Цитата:

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

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

Хелп непросто писать.
Автор хелпа должен обладать хорошей подготовкой.
Обычно проекты документирования затыкаются именно из-за этого.

Развернуть же какую-нибудь wiki очень просто.
ЛЮБЫЕ сотрудники быстро понимают как вносить туда новую информацию.
Это значит, что ваши активные пользователи, которые готовы вносить что-то (или делать запросы вам), смогут пользоваться

Например, www.erpkb.com

Еще раз. Проекты документирования обычно проваливаются потому, что создание хелпов непростое дело. Упростите создание хелпов.

[mazzy]

Цитата:

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

А вот про это не думали?

Заметки Фирмы

Или так.
но здесь тоже требуется определенная квалификация...

[Uni_DeMoN_imported]

Будем думать как лучше
вам в любом случае спасибо за интересные предложения.

[Тимур_imported]

Что реально я делал: описывал процессы управления предприятий, автоматизированные Navision с ссылкой на процедуры работы в системе. Все значимые поля в формах и отчетах описывались зачем и почему. Делали подсказки к полям.
Отдельно писали документацию на модификации: человек, ставивший задание на модификации, и человек, их выполнявший.
Вордовые файлы с гиперссылками. Один раз пробовал использовать On Target Modeller - не очень удобно оказалось. Пока что лучше OBM средств не знаю, но оно для Oracle.

[Uni_DeMoN_imported]

из данной темы ясно одно - описывать бизнес логику функционально новых средств систем на предприятиях надо и это, если позволите, главным образом положительно сказывается на максимально правильном использовании данных систем именно по назначению а не просто, извините, пустым тыканьем в отчётах, формах, когда в конечном итоге всё упирается в такое:
"... А Чё это не правильно работает..."
Да и вообще систематизация данного вида функциональностей и увязанием их в единое целое - некоего вида базу знаний, считаю по сей день серьёзной проблемой.
пока лишь видится реализация некоего внутреннего .chm файла с тематическими разделами и удобной системой навигации.
Разделы:
1)что в принципе позволяет данный функционал (все возможные разрезы, описание данного функционала).
2)технические аспекты данного функционала (может использоваться для программеров в качестве описания того, чего они в нём наколбасили более предметным языком, с вставками из кода, возможные пути модификаций и чё нибудь ещё, например, номер icq свой ;0)
3)ведение истории по модификациям.
4)То, что ещё хотят, но пока ещё не увидели в этой функциональности видеть люди, работающие с этой ф-тью. Что-то типа переписки прогерра и фин. директора.
5)Комментарии. Сюда писать комменты.
При всём при этом конструируемая система справки должна легко обновляться. Не знаю, возможно ли будет прикрутить доступ к этому файлу на основе текущих ролей пользователей (скажем менеджер сможет добавлять комментарии, а главный менеджер сможет писать в пункт 4) и т. д.)

ps хотя пункты 2) и 3) реализуются непосредственно в коде. Так что они здесь наверное не нужны.
Как Вам такое видится?

[mazzy]

Интересно.
Но первое, что приходит в голову - либо форум, либо вики.
Вики действительно удобная штука для того, чтобы разные люди создавали общий контент...

[Uni_DeMoN_imported]

Цитата:

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

Интересно.
Но первое, что приходит в голову - либо форум, либо вики.
Вики действительно удобная штука для того, чтобы разные люди создавали общий контент...

мне надо будет почитать про wiki более глубоко
информации пока по этой теме на самом деле не много,
а потом посмотрим, куда клюнет ткнуться...
Спасибо, mazzy.