Граф связей
Поиск отвечает, где про это написано. Граф отвечает, что с этим связано: какой раздел содержит документ, кто на него ссылается, кто его писал и что помечено тем же тегом.
Из чего он состоит
Узлы: страницы, внешние документы (Google-доки, презентации, доски Miro), задачи, теги и люди.
Рёбра:
| Связь | Откуда берётся |
|---|---|
| Вложенность | дерево страниц |
| Ссылка | … в тексте, ссылка на Google-док или доску |
| Пометка тегом | #тег в тексте и блок тегов |
| Авторство | история правок: кто создал, кто редактировал |
| Исполнитель | задача и человек, на котором она висит |
Он собирается сам
Граф производный: он наполняется при индексации из текста страниц и руками не правится. Отдельного экрана «завести связь» нет и не будет — связь появляется ровно там, где вы её написали в тексте.
Отсюда практическое следствие: база, написанная раньше, чем появилась какая-нибудь возможность графа, увидит её только после пересборки. Кнопка «Разобрать связи заново» на карте пересобирает граф проекта целиком; она же нужна, если связи выглядят неполными. Пересобирать может тот, у кого есть право на правку.
Панель «Связи»
Под каждой страницей — кто на неё ссылается, на что ссылается она, какими тегами помечена и кто писал. Обратные ссылки проставлять не нужно: страница, на которую сослались, узнаёт об этом сама — в её собственном тексте этой ссылки нет по определению.
Карта
Пункт «Карта связей» под деревом страниц. Что она умеет:
- фокус по клику — карта перестраивается вокруг выбранного узла; «Показать весь проект» возвращает общий вид;
- глубина 1–3 шага — сколько «пересадок» от фокуса показывать;
- фильтры — вложенность, теги, авторы, одиночные узлы. Выключенное убирается и из картинки, и из расчёта;
- переход в документ — клик по узлу открывает страницу, внешний документ или задачу в источнике.
Карта живёт по своему адресу, поэтому ссылкой на нужный вид можно поделиться.
На дашборде есть мини-карта: самая цитируемая страница проекта, самая живая или выбранный тег — и вход в полную.
Зачем это на практике
Что сломается, если переписать. Перед правкой видно, кто на документ опирается: четыре страницы онбординга, ссылающиеся на регламент, — повод поправить и их.
Что осиротело. Узел без единой связи — обычно либо забытый документ, либо тот, на который забыли сослаться.
Агент правит не вслепую. Читая документ, агент получает вместе с ним его связи и задачи — и не переписывает страницу, не заметив, что раздел вокруг неё говорит обратное. См. Что агент умеет.
Люди на карте
Авторство — часть графа, и внутри проекта видно, кто что писал. На публичном сайте документации людей нет: узлы-авторы и рёбра авторства отрезаются на сервере, а не прячутся в вёрстке. Связи документов снаружи — часть документации, имена сотрудников — нет.