Статьи

Как разобраться в сложной теме: слои вместо одной огромной схемы

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

Вкладки, снова вкладки

  • Изучая новую тему, быстро обрастаешь открытыми вкладками. Каждая ведёт к следующему вопросу, и основная линия теряется.
  • Постоянная развилка: идти дальше по маршруту книги или курса — или нырнуть в ответвление, которое кажется важным прямо сейчас.
  • Таблица на 20–30 листов с перекрёстными ссылками перестаёт читаться. Схема в Miro или draw.io превращается в клубок.

Импульс у всех один: отрезать лишнее, чтобы снова понимать, что происходит.

В компаниях то же самое, только быстрее

Растут домены, процессы, артефакты и базы данных. Цифровые двойники добавляют многослойные графы сущностей и связей. Узкое место смещается: создать документ, схему или код стало дёшево, а понять и проверить созданное — нет. Это называют долгом понимания, или когнитивным долгом.

Языковые модели ускоряют создание ещё сильнее, так что разрыв между «сделано» и «понято» только растёт. Задокументировать всё подряд невозможно. Нужно уметь смотреть на ту часть, которая важна сейчас, и не терять связи с остальным.

Подсказка первая: вики, которую ведёт модель

Андрей Карпатый описал идею LLM Wiki: модель сама поддерживает базу знаний — разбирает источники, обновляет страницы и ставит перекрёстные ссылки, а исходные материалы хранятся отдельно от того, что из них собрано.

Самая полезная мысль оттуда — сохранять небольшие связанные представления под конкретный вопрос, чтобы потом возвращаться к результатам анализа, а не начинать заново.

Подсказка вторая: как устроена техническая документация

В больших компаниях документацию давно ведут не документами, а компонентами. Для этого есть системы управления компонентным контентом — CCMS:

  • один компонент используется в сотнях документов;
  • текст отделён от оформления — например, по стандарту DITA на основе XML;
  • из одной базы компонентов собираются PDF, веб-страницы и справка;
  • когда меняется абзац, переводчикам уходит только он;
  • история версий ведётся по компонентам, а не по документам целиком.

Главная мысль для схем: менять в одном месте, а видеть везде, где компонент используется.

Гипотеза: разложить граф по листам

  • Узлы и связи раскладываются по нескольким листам, и каждый лист посвящён своей части темы.
  • Связи работают и внутри листа, и между узлами разных листов.
  • Одна сущность может жить на нескольких листах — это тот же компонент из CCMS, только на схеме. Описание меняется один раз и обновляется везде.
  • Листы можно вести в разных нотациях, от свободных заметок до строгих схем. PlyLoom умеет импортировать схемы из draw.io, BPMN и Obsidian Canvas.
  • Модель может помочь найти связи между материалами, но предложенные связи проверяет человек: модели путают сущности, условия и направления зависимостей.

Как это выглядит на практике

Возьмём небольшую обжарку кофе:

  1. Сначала всё на одной схеме: поставщики, обжарка, упаковка, каналы продаж, деньги. Через пару десятков узлов её уже трудно читать: темы перемешаны, и каждая новая связь добавляет пересечений.
Учебная обжарка на одном поле: 26 узлов и 32 связи, закупка, производство, продажи и деньги вперемешку
Шаг 1. Вся обжарка на одном поле: 26 узлов и 32 связи. Расставлено аккуратно, но закупка, производство, продажи и деньги стоят вперемешку. Данные учебные, числа вымышлены.
  1. Узлы раскладываются по листам: закупка зерна, производство, продажи, финансы. Связи с другими листами видны на рамке вокруг листа — группа на каждый соседний лист, — и понятно, куда тема уходит дальше.
Лист «Производство»: процесс от партии зерна до пакета, слева на рамке закупка, справа продажи, снизу финансы
Шаг 2. Лист «Производство»: на нём только процесс от партии зерна до пакета. Закупка, продажи и финансы — на рамке, со своими узлами.
  1. «Разворот» ставит рядом производство и продажи: видны связи между ними и ничего лишнего.
Разворот из двух листов: производство и продажи, пунктирные связи между окнами и золотая линия пакета 250 г
Шаг 3. «Разворот»: производство и продажи рядом. Золотая линия соединяет «Пакет 250 г» на обоих листах — это одна сущность, а не две копии.
  1. «Стопка» показывает все слои друг над другом, когда нужно понять устройство целиком.
Стопка из четырёх листов-слоёв: закупка, производство, продажи и финансы, связи между слоями
Шаг 4. «Стопка»: четыре листа — четыре слоя, связи проходят между ними.
  1. «Оглавление» и «Обзор листов» помогают ориентироваться, когда листов становится много.
Оглавление: четыре листа обжарки, число узлов на каждом и число связей между листами
Шаг 5. «Оглавление»: сколько узлов на каждом листе и сколько связей и общих узлов между листами. Щелчок по числу на линии открывает эти два листа рядом.
  1. Результат можно выгрузить в draw.io или в формат JSON Canvas для Obsidian.

Открытые вопросы

  • Хватит ли слоёв, чтобы справляться со сложностью современных систем?
  • Где граница между автоматикой и проверкой человеком?
  • Может ли визуальный инструмент передать многомерность знаний, или любая схема останется проекцией?

PlyLoom — попытка отвечать на эти вопросы на практике: на картах, которые можно открыть, поправить и проверить.

Первая версия этой статьи и обсуждение — на Хабре. Скриншоты сняты с версии 0.9.1.

Читайте также

PlyLoom 0.14: больше места для работы

Карте отдано почти всё окно: верх сворачивается, карточки как в draw.io, паспарту в трёх состояниях, картинки в узлах и рассказ по шагам.

На арене PlyLoom: Qwen против DeepSeek

Две модели, один вопрос, две карты: что карта показывает сразу — дубли, открытые вопросы — и почему PlyLoom 0.14 спрашивает, откуда брать факты.