Вы правы, поддерживать актуальность документации сложная задача. Ее решали тоже системно. Как именно - расскажем в следующей серии :)

Мы пользуемся приемуществами self-hosted решения: данные хранятся у нас и управляются нами

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

К сожалению, показать реальные скриншоты из внутренней БЗ не можем из соображения безопасности данных, но по визуализации реальность отвечает этой схеме:

Здесь мы перерисовали интерфейс программы и расположили все элементы так, как в системе.

Учить не обязательно, главное, знать, где можно подсмотреть нужный тег)

У нас есть подробная инструкция по работе макроса и гиперспейса в целом, плюс таблицы с тегами. Мы даем на них ссылки, когда передаем гиперспейс в продуктовую команду. К ним можно обратиться в любое время.

У нас есть таблицы, в которых записаны теги и типы статей, для которых они должны проставляться. Сейчас это делается вручную, а теги сильно отличаются друг от друга, чтобы дубликаты не появлялись. Пока тегов не слишком много, их расставление не вызывает труда. В будущем можно подумать над автоматизацией процесса.

Спасибо за фидбек! Рада, что она показалась полезной)

Чтобы разделить страницу на блоки, воспользуйтесь «Разметкой страницы», которая находится в панели простого текстового редактора. Жмете "Добавить раздел", появляется строка, которую можно разделить на 1, 2 или 3 колонки. Чтобы добавить еще строки, снова жмете на "добавить раздел". На одной странице может быть много разделов с разной разметкой)