Пакетне оновлення бази знань, не втрачаючи контролю над змінами

Інвентаризуйте зачеплений вміст перед створенням тексту

Почніть із зміни продукту та знайдіть у наявному вмісті старий термін, правило чи процедуру. Запишіть ідентифікатори статей, макроси підтримки, повідомлення про адаптацію та внутрішні інструкції, у яких це може згадуватися. Не думайте, що схожі назви означають ідентичний вміст або що модель знає кожне місце, де з’являється старе формулювання.

Підготуйте один затверджений опис змін: попередня поведінка, нова поведінка, дата набуття чинності, винятки й точна термінологія. Призначте відповідального за невизначені факти. Відокремте фактичні оновлення від необов’язкового стилістичного редагування, щоб гарніше речення не приховало зміни правила. Рекомендації Google щодо процедур радять чіткі дії та явний контекст; застосуйте цей стандарт до всієї групи.

Ведіть реєстр кожного матеріалу до публікації

Уявімо вигаданий сервіс, у якому змінилося розташування кнопки експорту. Затверджений новий шлях — Звіти → Експорт; права доступу й формати результату незмінні. До переліку входять інструкція, контрольний список і відповідь підтримки. Ці ілюстративні дані не описують інтерфейс Colay.

Матеріали потребують різних змін: повній інструкції може знадобитися новий знімок екрана, контрольному списку — одна назва, сценарію підтримки — лише виправлений шлях. Вісім повних переписувань кожного матеріалу збільшать обсяг перевірки, але не обов’язково поліпшать оновлення.

Відпрацюйте підхід на невеликій репрезентативній вибірці

Під час налаштування підходу можуть бути корисними вісім форматів: стисла процедура, пояснення для початківців, усунення несправностей, запитання й відповіді, відповідь підтримки, внутрішній контрольний список, проста доступна мова та короткий підсумок. Оберіть формати, яких справді потребує ваш перелік. Результат — узгоджене правило редагування, а не вісім конкурентних версій кожної сторінки.

1. Виберіть одну просту статтю, одну статтю з винятками та один сценарій підтримки. Створіть їх перед обробкою решти інвентарю.
2. Дайте доступним агентам Colay однаковий опис змін і попросіть різні редакторські підходи. Порівняйте, чи зберігають вони незмінні правила.
3. Затвердити шаблон редагування та список термінології. Зберігайте приклади прийнятих і відхилених змін поруч із пакетним описом.
4. Опрацюйте контрольовані групи вмісту вручну, зберігаючи ідентифікатор кожного елемента та його вихідну версію. Зупиніть пакет, коли з’явиться нове протиріччя.

Запит для одного матеріалу зі збереженням історії змін

Надавайте лише дозволені для цього матеріали та не вказуйте непотрібні відомості про клієнта. Зберігайте авторитетний реєстр у вашій існуючій системі документів або вмісту. Створена Colay відповідь сама по собі не оновлює стан публікації елемента.

Оновіть елемент вмісту [ідентифікатор і вихідну версію] за допомогою цієї затвердженої таблиці змін: [попередня поведінка, нова поведінка, дата набуття чинності, винятки]. Існуючий текст: [текст]. Затверджена термінологія та порядок редагування: [правила]. Поверніть відредагований текст, список змінених фрагментів із зазначенням причин, незмінені правила, які ви зберегли, і питання, які блокують публікацію. Змінюйте лише відповідний вміст. Зберігайте посилання та ідентифікатори, якщо в брифі їх явно не змінено. Не придумуйте нові мітки інтерфейсу користувача, дозволи, дати чи поведінку продукту. Якщо цей елемент конфліктує з аркушем змін, позначте конфлікт, а не вирішуйте його здогадками.

Публікуйте перевіреними групами й зберігайте можливість повернення

Перед публікацією перевірте кожну змінену інструкцію, виняток і посилання на відповідність затвердженому джерелу та фактичному продукту. Перегляньте весь документ навколо редагувань: виправлений абзац все ще може суперечити незміненому вступу. Запишіть схвалювача та збережіть попередню версію вмісту.

Опублікуйте через наявні інструменти й перевірте живу статтю та збережені відповіді, що на неї посилаються. Лише після цього позначте матеріал завершеним. Для оцінки процесу вимірюйте час редагування й виправлення після публікації. Робота групами може скоротити повторення брифів, але результат залежить від матеріалів і перевірки; гарантованої економії цілого тижня немає.

Відповіді на запитання