Применимость: Cloud. Названия пунктов и доступность функций зависят от версии, плана и типа проекта. Проверяйте изменения на тестовом окружении. Описанные рабочие процедуры — предлагаемый подход, а не гарантии поставщика.
Сценарий: поддержка постоянно спрашивает одно и то же
В компании с тремя продуктовыми командами уже есть сотни страниц Confluence, но новые сотрудники всё равно спрашивают коллег о подключении клиента и восстановлении доступа. Начните с десяти повторяющихся обращений за последний месяц. Для каждого запишите формулировку вопроса, правильный ответ, аудиторию и последствия ошибки. Получится рабочая карта потребностей, а не перечень отделов. Цель пилота — сократить время поиска ответа для этих десяти вопросов. Дерево страниц и внешний вид главной пока вторичны: сначала нужно понять, какой результат человек должен получить после чтения и какое действие он сможет выполнить самостоятельно.
Разделите знания по типу использования
Предлагаемая схема содержит четыре направления: выполнить операцию, разобраться в понятии, устранить проблему, узнать принятое решение. У инструкции есть предварительные условия и шаги; у справочника — определения и ограничения; у диагностики — наблюдаемые симптомы и развилки; у решения — контекст и последствия выбора. Один материал может ссылаться на другой, но не обязан содержать всё сразу. Например, статья о повторной отправке уведомления ссылается на описание очереди сообщений. Это позволяет обновлять техническое объяснение независимо от действий оператора. На главной разместите понятные пользователю маршруты: «Подключить клиента» и «Письмо не пришло», а не внутренние названия команд.
Выберите границу пространства и доступ
Пространство удобно рассматривать как границу управления и аудитории. Документацию для всей поддержки не стоит смешивать с закрытыми материалами расследований, рассчитывая исключительно на ограничения отдельных страниц. В Confluence Cloud доступ складывается из нескольких уровней; конкретные ограничения необходимо проверить на вашем сайте. Перед созданием дерева составьте матрицу: кто читает, кто редактирует, кто управляет доступом. Используйте группы, соответствующие рабочим ролям. Отдельно проверьте, не включён ли анонимный доступ. Технические механизмы описаны в официальной документации; предложенная организация материалов является редакционной практикой, а не обязательной структурой продукта.
Заведите минимальный договор о качестве
Для каждой инструкции назначьте ответственного человека или команду, укажите дату последней проверки и систему, к которой относятся шаги. Добавьте условия применимости: рабочая среда, роль пользователя, требуемые права. Договоритесь, что скриншот помогает найти элемент интерфейса, но не заменяет текстовое действие. Секреты, настоящие персональные данные и клиентские токены не должны попадать в примеры. Изменение шаблона не исправит старые страницы автоматически: планируйте отдельный проход по пилотной выборке. Не вводите двадцать обязательных полей сразу. Пять реально поддерживаемых атрибутов полезнее длинного паспорта, который авторы заполняют случайными значениями перед публикацией.
Проверьте маршруты на пяти читателях
Попросите сотрудников, не участвовавших в проектировании, решить два задания: найти инструкцию подключения и определить действия при недоставленном письме. Не подсказывайте название страницы и не объясняйте дерево. Запишите время, поисковые запросы, ошибочные переходы и момент, когда человек перестал доверять найденному ответу. После теста исправляйте конкретную причину: непонятный заголовок, отсутствующий синоним, недействующую ссылку или несоответствие прав. Поиск от администратора не заменяет тест обычного читателя. Повторите проверку после изменений на других участниках. Успех — выполнение задачи с правильным результатом, а не количество просмотров красивой стартовой страницы.
Переносите постепенно и сохраняйте путь назад
Сначала приведите в порядок десять ключевых ответов, затем добавляйте следующую тематическую группу. До перемещения составьте таблицу старых адресов, владельцев и основных входящих ссылок. Дубли пометьте ссылкой на основной материал и согласуйте дальнейшую судьбу с владельцем. Не удаляйте содержимое только потому, что оно давно не менялось: стабильная процедура тоже может быть правильной. Если новая навигация ухудшила поиск, верните прежнюю стартовую страницу, сохранив подготовленные материалы. Через месяц сравните повторные обращения и результаты контрольных заданий. Отдельно проверьте, не выросло ли число запросов доступа к статьям после перестройки структуры.
Карточка пилота для владельца базы знаний
До начала пилота заведите небольшой рабочий документ с исходными показателями. В нём достаточно указать десять вопросов, число повторных обращений, среднее время поиска на учебном задании и ответственного за каждый ответ. Не сравнивайте разные по сложности выборки: если сначала проверяли простой вход в систему, а затем аварийное восстановление, изменение времени ничего не доказывает. При тестировании просите читателя вслух объяснять, почему он выбрал конкретную ссылку. Так обнаруживаются ложные ассоциации, которые не видны в статистике просмотров. После публикации назначьте короткую встречу владельцев и рассмотрите только реальные затруднения, без обсуждения оформления всего сайта. Полезный артефакт пилота — таблица причин неудачного поиска и внесённых исправлений. Если большинство проблем вызвано отсутствием доступа, сначала исправьте модель разрешений. Если ответы находятся, но действия не выполняются, переработайте содержание инструкций. Эти ситуации требуют разных изменений.
Официальная документация
Применить это к вашей системе
Обсудим контекст, ограничения и безопасный порядок изменений.
Обсудить задачу