Возможно, вам потребуется спроектировать промежуточное ПО, расположенное на уровне между приложением и справочной системой. Это .j ПО интерпретирует или получает контекст (например, имя формы и имя [ поля), преобразует его в допустимую ссылку и вызывает справочную систему, цитируя эту ссылку. Очевидное место для хранения соответствия I между экранным контекстом и ссылкой на справочную систему - база данных. Однако если стандарты на именование контекстов соблюдаются не строго, то полученная в результате справочная система будет неудобной и непредсказуемой.

В Oracle Designer/2000 версии 1.2А и выше есть генератор, который создает справки в формате Microsoft Help на базе описаний таблиц и модулей. Но если эти описания не составлены так, чтобы они были понятны для пользователей, то такая система, конечно, будет классическим образцом системы КЗТО ( каков запрос, таков ответ ). В большинстве проектов много сил тратится на то, чтобы описания были понятыми для программистов!

Лучше привлечь к подготовке справочного текста пользователя, а еше лучше - профессионального технического писателя. Если его напишет разработчик, то в этом тексте будет слишком сильный системный увигон и он будет основан на понимании разработчиком принципов использования системы. Справочный текст следует писать простым языком, используя стандартную терминологию бизнеса. То, что разработчик может объяснить блоками и функциями, пользователь лучше объяснит бизнес-процессами.

Приложения

в приложениях содержится следующая информация:

В приложении А, Готовые пакеты прикладных программ , описаны выгоды от приобретения готового пакета прикладных программ, а также рассказывается, как правильно выбрать продукт.

В приложении Б, Секреты мастерства , мы предложим метод, позволяющий обойти проблему мутирующих таблиц в триггерах Oracle?, рассмотрим проблемы, связанные с неизбежным наступлением нового тысячелетия, и ознакомим читателя с расщиренным SQL.