Лекция «Архитектура базы знаний — как расставить документы так, чтобы ответ находили, а не писали заново»

Около 55 минут на 13 тем. Прогресс сохраняется, поэтому лекцию можно проходить частями и возвращаться к ней позже.

Начало — да: первые 1 тема открыты сразу, без регистрации. После бесплатной регистрации откроются темы до 2-й — вместе с частью из 39 тестов и монетами за верные ответы. Полная лекция — 99 ₽ навсегда, либо подписка на все лекции платформы от 499 ₽ в месяц.

Тринадцать тем об одном: как множество нормально написанных документов превращается в систему, в которой находят ответ. Начало — с цифр отчёта Postman «2025 State of the API Report» (октябрь 2025, более 5700 опрошенных): 55% команд называют пробелы в документации, 35% дублируют усилия, 34% не могут найти существующие наработки, и последние два числа описывают одно явление с двух сторон. Дальше каркас из книги Rosenfeld, Morville и Arango (4-е издание, O'Reilly, 2015): организация, маркирование, навигация, поиск плюс невидимые системы — и свой измеримый провал у каждой подсистемы. Глубина дерева разобрана по эксперименту Larson и Czerwinski (CHI '98): 512 узлов, три раскладки, 58, 46 и 36 секунд, 19 участников, и победила не самая плоская структура, а средняя — вывод, который чаще всего перевирают. Модель Miller и Remington объясняет почему: при неоднозначности подписей выше 0.2 глубина резко проигрывает, а для веба параметр оценён около 0.4, так что честные названия буквально покупают уровень вложенности. Отдельная тема разбирает миф о семи пунктах в меню: работа Miller 1956 года описывает элементы с одним признаком и воспроизведение по памяти, Cowan в 2001-м уточнил предел до четырёх чанков, а видимое меню узнают, а не вспоминают. Информационный фуражинг Pirolli и Card (1999) объясняет, почему «Прочее» не пахнет ничем, работа Furnas и соавторов (CACM, 1987) даёт цифру меньше 0.20 совпадения терминов у двух людей и 80–90% отказов при доступе по одному слову, а Baker («Every Page is Page One», 2013) разворачивает лекцию: до дерева большинство читателей не доберётся, и страница обязана держать контекст в одиночку. Последняя треть — измерения и практика: поиск как вторая архитектура, разбор нулевых запросов с тремя разными диагнозами, карточная сортировка против древовидного тестирования с честной вилкой чисел и порядок работ на понедельник, в котором перестраивается только то, что измеримо не работает.

Нет, и Baker в «Every Page is Page One» (2013) отдельно это оговаривает: темы, спроектированные для навигации снизу вверх, могут одновременно быть частью структуры сверху вниз. Дерево остаётся — меняется отношение к нему. Оно перестаёт быть единственным путём на страницу, потому что заметная часть читателей приходит из поиска, по ссылке от коллеги или из обращения и вашего меню не видит вовсе. Практическая работа тут не в сносе иерархии, а в добавлении того, чего у страницы обычно нет: самодостаточного заголовка, понятного без раздела, пары строк «что это и для кого» в начале и явных ссылок на соседей по смыслу. Проверяется просто — откройте страницу по прямой ссылке, мысленно спрятав меню и хлебные крошки, и посмотрите, понятно ли из первых двух экранов, о чём речь и что делать дальше.

Нет, и это осознанная граница. Все принципы лекции — разрез контента, глубина дерева, честность подписей, синонимы и метаданные, разбор нулевых запросов, карточная сортировка и древовидное тестирование — работают на любой среде и ни один из них не требует конкретного движка. Названия систем в тексте встречаются только как пример среды, без сравнения и рекомендаций. Практический смысл этой границы в том, что смена платформы не чинит архитектуру: раздел «Прочее» переезжает на новый движок вместе со всем остальным, а запросы без результатов остаются без результатов. Инструменты сборки и публикации документации — тема отдельной лекции.