Вопросы. Как устроен текст руководства?

Анатолий Левенчук · Поиск в руководстве · MCP

Открыть это место в полном тексте руководства →

Вопросы. Как устроен текст руководства?

Отметьте правильные высказывания.

--- Материал руководства по системному мышлению тщательно сгруппирован по темам: в одном разделе и далее подразделах раскрывается одна мысль, мысли не повторяются. ### Нет, в одном разделе может быть изложено (даже неполностью) множество мыслей, и мысли эти повторяются. Это не справочник, это руководство/guide: материал для обучения нейронной сети в мозгу инженеров-менеджеров, а не материал справочника для загрузки в компьютер.

--- Каждая тема руководства по системному мышлению излагается компактно и последовательно, чтобы проще было потом находить нужный фрагмент текста с исчерпывающим объяснением. ### Нет, наставления руководства излагаются «вперемешку» (interleaving), причём ожидается, что материал по одной теме излагается с некоторыми перерывами, растянуто во времени (spacing). Текст оптимизирован для обучения, а не для того, чтобы быть справочником.

--- Ваши заметки по руководству нужно публиковать в блоге, чтобы о них узнали нейросетки читателей вашего блога. ### Нет, ваши заметки нужно публиковать в блоге не для того, чтобы кто-то внешний прочёл ваши мысли. Ваши заметки нужно публиковать в блоге, чтобы ваша собственная нейросетка получила дополнительный шанс размышлять над содержанием руководства, а факт публикации нужен для того, чтобы вы не соблазнялись не прописывать полностью термины, опускать важные объяснения и другими способами оставлять в голове вместо слов и фраз неясные ощущения, которые в словах выражаются просто как «ну, понятно». Надо уметь разговаривать на темы системного мышления, для этого надо писать, писать, писать!

--- Автор не знает, что писать термины через слеш прямо не рекомендуется в учебниках по стилю письма. ### Нет, автор знает о том, что написано в учебниках по стилистике текстов. Но текст учебника — это текст совсем не того стиля, для которого написаны руководства по стилям, включая руководства по так называемому «инфостилю». Наставления руководства — это не реклама, не маркетинг, не научный текст. Это руководство, его задача — научить системно мыслить, причём научить надёжно.

+++ Использование многочисленных скобок и сложносочинённых предложений улучшает текст. Не надо писать короткими удобочитаемыми фразами! ### Да, дополнительные элементы текста для демонстрации его структуры (скобки, показ зависимостей в сложных предложениях) улучшают учебные свойства текста. Были проведены эксперименты, которые показали, что текст с простыми отдельными фразами сложней «собирается» в головах людей. После какого-то количества экспериментов было принято решение оставить стиль текста с обилием скобок и сложносочинёнными (сложное предложение, состоящие из равноправных частей) и сложноподчинёнными (сложное предложение, состоящее из главной и зависимой частей) предложениями.