Применимость: Cloud. Названия пунктов и доступность функций зависят от версии, плана и типа проекта. Проверяйте изменения на тестовом окружении. Описанные рабочие процедуры — предлагаемый подход, а не гарантии поставщика.
Почему дерево не решает все задачи
Инструкция по подключению интеграции одновременно относится к продукту, поддержке и информационной безопасности. В дереве у неё одно основное положение, а читатели приходят из разных маршрутов. Метки позволяют добавить тематические связи без копирования текста. В нашем сценарии нужно собрать все инструкции по интеграциям и отдельно показать материалы, ожидающие проверки владельцем. Начните с конкретных подборок, которые действительно нужны команде. Если ни один читатель не использует будущую категорию, создавать её заранее не стоит. Классификация должна уменьшать время поиска и редакционной работы, а не превращаться в самостоятельный бюрократический проект.
Согласуйте словарь и правила именования
Подготовьте небольшой список меток по независимым признакам: тип материала, продукт и редакционная задача. Например, how-to, integration и review-needed. Это пример рабочего словаря, а не встроенные специальные значения Confluence. Для каждой метки определите назначение, владельца и пример подходящей страницы. Запретите неоднозначные синонимы вроде integrations и integration без согласования, но не требуйте сложных кодов, непонятных авторам. Включите правило создания новой метки: сначала объяснить, какую подборку она обеспечит. Слова должны быть достаточно стабильными, чтобы смена названия команды не потребовала переклассификации всей базы знаний.
Используйте метки в шаблонах и подборках
Confluence Cloud поддерживает метки содержимого и вложений. Метки, добавленные к шаблону, могут переходить в создаваемое из него содержимое. Это удобно для типа материала, но не всегда подходит для продукта: один шаблон инструкции используют разные команды. Для отображения подборок доступны соответствующие макросы, например таблица отчёта по содержимому. Выберите поддерживаемый вашим редактором инструмент и проверьте его настройки. Не обещайте сложные логические фильтры, пока не проверили конкретный макрос. На главной странице разместите одну полезную подборку и поясните, какие материалы должны в неё попадать.
Переклассифицируйте пилотную выборку
Возьмите двадцать инструкций об интеграциях. Для каждой сохраните старый набор меток и назначьте новый по словарю. Сначала добавляйте новые значения, проверяйте подборки и только после этого удаляйте устаревшие. Не переименовывайте все совпадения автоматически: метка может использоваться чужой командой в отчёте или навигационной странице. Попросите владельцев проверить пограничные случаи. Материал о диагностике интеграции может относиться сразу к инструкции и устранению проблемы; договоритесь, допустимо ли несколько типов. Зафиксируйте решение в словаре. Миграция должна иметь понятное окончание и способ вернуть прежние значения при ошибке.
Проверьте полноту и видимость
Создайте контрольный список из страниц, которые должны попасть в подборку, и нескольких страниц, которые не должны. Сравните фактический результат под учётной записью обычного читателя. Метки не предоставляют права доступа, поэтому у разных пользователей содержимое подборки может отличаться. Обнаруженное отсутствие страницы сначала проверяйте по её меткам и доступу, затем по параметрам макроса. Не снимайте ограничения ради полноты отчёта. Проверьте, что новая инструкция из шаблона получает нужную классификацию. Отдельно проверьте вложение: одинаковое слово в имени файла не означает, что файл действительно помечен.
Не превращайте метку в систему согласования
Значение review-needed удобно для рабочей очереди, но само по себе не доказывает согласование содержания и не обеспечивает аудит решения. Для критичных материалов фиксируйте владельца, основание проверки и результат в тексте или в принятом компанией процессе. Раз в квартал смотрите на неиспользуемые и дублирующие метки. Если новый словарь оказался неудобным, восстановите старые значения из таблицы пилота и пересоберите подборки. Не удаляйте метки, на которых основана чужая навигация, без проверки входящих зависимостей. Хорошая таксономия меняется редко и остаётся понятной новичку после короткого объяснения.
Как обнаружить плохую классификацию
Проведите простое редакционное упражнение: дайте двум авторам десять одинаковых страниц и попросите назначить метки независимо. Сравните результат по каждой странице. Разногласия показывают, где определение слишком широкое или одна метка смешивает несколько признаков. Например, слово support может означать аудиторию, владельца команды или тематику материала. Разделите смысл либо откажитесь от такого значения, если оно не поддерживает полезную подборку. Не выбирайте победителя голосованием без объяснения правила. Исправьте словарь, добавьте пограничный пример и повторите упражнение. После внедрения посмотрите, какие метки авторы вводят вручную вместо согласованных. Это может быть сигналом реальной недостающей категории, а не нарушением дисциплины. Сначала выясните задачу читателя, затем решайте, нужен новый термин или достаточно улучшить объяснение существующего. Так словарь остаётся небольшим и практически полезным.
Официальная документация
Применить это к вашей системе
Обсудим контекст, ограничения и безопасный порядок изменений.
Обсудить задачу