Придерживайтесь этой структуры при составлении документов - она облегчит понимание материалов пользователем.
Вы также должны держать в памяти :
Если, однако, ваш потенциальный читатель уже имеет некоторое представление о рассматриваемой области, то он уже сформировал свою собственную структуру материала. И тогда он будет ожидать появления необходимого материала во вполне определенных местах. И если вы заставите его следовать вашей структуре, не совпадающей с его представлениями, то он просто выйдет из вашего документа с нехорошим осадком в душе и больше не вернется :-(.
Если вы четко знаете, для кого пишете, то можете просто сформировать проходящую структуру. Если нет, то вам надо сделать так, чтобы все читатели могли найти подходящие для себя ссылки. Например, когда вы делаете какой-либо справочник , то можете делать такие вставки: "Если вы действительно хотите знать, как это работает внутри, то посмотрите Встроенное руководство", или "Руководство 'шаг-за-шагом' есть в Учебнике для начинающих".
Сделайте две раздельных отправных точки. Например, вы можете сделать руководство для начинающих и дерево-справочник по тому-же материалу. Это как несколько индексов в одной книге, причем руководство для начинающих может содержать информацию, недоступную из справочника.
Руководство Справочник
| |
| ------------------
Давайте сделаем | |
это вместе | |
шаг за шагом | |
| По функциональным По алфавиту
| группам |
Проблемно-ориентированные | |
примеры | |
| ------------------
| |
Примеры использования <----------------------> Синтаксис специальных
специальных функций функций
Новичок начнет с левой стороны, и будет продвигаться вниз. Когда ему
понадобится уточнения, он посмотрит пример. В принципе, он читает ту
же информацию, что и профессионал, который заглянул сюда лишь для
того, чтобы уточнить параметры какой-либо функции или посмотреть
пример ее использования.
Документ может иметь размер ссылки в книге.
Есть два ограничения на размер документа. Первое - большие документы долго пересылать ( хотя это зависит от ваших коммуникационных возможностей ), и пользователь не сможет быстро переходить между ними.
Другое ограничение состоит в том, что большие документы сложно просматривать. Читатели с символьными терминалами редко просматривают больше чем 3-5 экранов. Обычно они оценивают полезность информации с первого экрана, и в зависимости от этого смотрят дальше или уходят из документа. Для пользователей с графическим интерфейсом эта проблема не стоит. Более того, используя полосу прокрутки, они могут воспринимать информацию как непрерывный поток. Пожалуй, это единственный плюс больших документов.
Кстати, не надо сильно беспокоится о том, чтобы вставлять в документ больше количество внутренних ссылок. Если это проблема, вставьте лишь одну - на оглавление документа. Все просмотрщики сейчас имеют возможность возврата на предыдущую позицию, а некоторые и более совершенные средства типа history.
Примерные правила для размера документа следующие:
Вот несколько причин, чтобы оставить ее на месте: