Эволюция справочной службы:
- Сплошной текст.
- Справочники:
- с линейной структурой;
- древовидной (иерархической) структурой.
Объединение справочника и связной документации. Для этого нужно очень удачно подобранный текст. В справочнике появляется проблема формулировки запроса.
- Способ борьбы с этой проблемой – появление индексов, но удовлетворительного решения проблемы нет.
- Многоуровневые справочники:
- 1 уровень – синтаксис;
- 2 уровень – семантика;
- 3 уровень – примеры команд;
- 4 уровень – отсылка к бумажной документации.
v Стандартный механизм справочника – гипертекст.
v Контекстно-зависимая помощь.
v Справка на служебные слова.
v Листание полученных справок (возможно вперед и назад).
v Перенос информации из справочника в рабочий файл при этом объекты не обязательно должны быть текстовыми.
Help Maple
- introduction – введение в систему;
- help on context – контекстная справка;
- new user tour – введение для нового пользователя;
- what’s new – что нового в этой версии системы;
- using help – как пользоваться help’ом;
----
- topic search – статьи в справочнике;
- full text search – полнотекстный поиск;
- history – история запросов;
---
- save to date base – добавить новую статью;
- remove topic – удалить статью;
---
- balloon help – включить/выключить всплывающее меню;
---
- about maple – о программе.
Справочник иерархический. Каждая страница состоит из 5 частей:
- краткая информация;
- формат вызова;
- подробное описание;
- примеры;
- список ссылок (куда еще можно посмотреть)
Листание (вперед, назад в порядке листания; вперед, назад по алфавиту; перейти в крайнюю позицию)
Наращиваемость справочника – это отдельная возможность. Проблемы при дописывании:
- исправлять, удалять;
- кому давать доступ;
- нужно ли выделить стандартную часть справочника;
- и т.д.