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

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

Архив
Многие современные паттерны документации выросли из старых задач гипертекста: как делить информацию, называть переходы и помогать читателю вернуться, если он потерял контекст. Гипертекст освободил читателя от линейного руководства и сразу создал проблему ориентации.

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