Без заголовка
FAQ - это ответы на вопросы в парадигме "Как сделать это". Документация и учебные материалы исходят из парадигмы "что можно сделать с помощью"...
Дальнейший абзац относится прежде всего к программистской документации, поскольку пользовательская в руки давно не попадалась.
В документацию программистскую часто попадает перечисление ключей программы, функций библиотеки и тому подобные вещи. Примеров, как правило, нет (за редкими исключениями). Поэтому у меня большая проблема с юниксовыми man'ами. В учебных материалах можно отыскать примеры, которые описывают только одно - в каком порядке вызывать оные функции. Как правило, таким способом можно достичь тривиального результата, а иллюстрируется не достижение цели, а применение средства.