Короткий ответ
База знаний Contoso начинается с двадцати карточек, закрывающих самые частые обращения, не с «портала знаний». Формат: симптомы, что проверить, решение, как убедиться, ссылка на CHG/опасности. Источник — закрытые тикеты и журнал работ, не фантазия «как должно быть».
Владелец KB — Иван Петров; у каждой карточки — автор и lastReviewed. Пустая Confluence на 400 разделов хуже папки из 20 живых файлов.
Симптомы и как отличить
Типичная картина:
- новый админ час ищет, как подключить сканер;
- один человек помнит «хитрость с 1С»;
- вики есть, даты 2019, команды не работают на Server 2022;
- в тикетах копипаст из лички.
Отличия:
| Артефакт | Не KB | Куда |
|---|---|---|
| Журнал «что сделали вчера» | факт работ | журнал |
| Паспорт FILE01 | карточка узла | паспорт |
| DRP | авария площадки | DRP |
| Регламент backup | политика копий | регламент backup |
Возможные причины
- Хотели идеальную таксономию, не начали.
- Писать некогда, «и так знаем».
- Наказание за ошибку в статье — перестали писать.
- Секреты в текстах, ИБ запретила, безопасную версию не сделали.
- Инструмент внедрили, контент не завели.
- Редко: всё в голове подрядчика по договору «уникальная экспертиза».
Диагностика
Выгрузите топ-20 тем тикетов за квартал (категории, темы, текст). Это и есть бэклог KB. Если тикетов нет — сначала канал учёта.
Чеклист «карточки нет»:
- сброс пароля AD / блокировка учётки;
- нет сети / DNS;
- не открывается шара;
- VPN не цепляется;
- 1С «сеанс»;
- диск C: заполнен на терминале;
- очередь печати;
- новый сотрудник (доступ, почта);
- как проверить backup job;
- как понять P1 vs P3.
Если из списка закрыто нулями статей — KB нет, даже если wiki установлена.
Поищите секрет в существующей вики: пароли, ключи. Это блокер публикации, не повод не писать.
Решение
Шаблон карточки (одна-две страницы)
- Заголовок языком пользователя.
- Симптомы.
- Где бывает (WS2022 / Ubuntu 24.04 / 1С).
- Диагностика: 3–7 шагов, команды с
contoso.example. - Решение.
- Проверка.
- Когда эскалировать.
- Автор, дата.
Пример заготовки «учётка заблокирована»:
Get-ADUser -Identity 'j.doe' -Properties LockedOut, LastBadPasswordAttempt, Enabled |
Select-Object SamAccountName, LockedOut, LastBadPasswordAttempt, Enabled
Unlock-ADAccount -Identity 'j.doe'В карточке: не разблокировать без идентификации личности по вашему регламенту.
Как выбрать первые 20
Не алфавит. Сортировка по частоте × время на инцидент. P1-runbook (AD, почта, 1С) входят даже при низкой частоте.
Где хранить
То, что откроется без единственного автора. Markdown в git, wiki, даже файлы в \\FILE01\IT\KB с ACL. Поиск важнее красоты.
Процесс обновления
После третьего похожего тикета — карточка или дополнение. После неудачного следования статье — правка в ту же смену, не «в бэклог мечты».
Откуда брать тексты, чтобы не выдумать
Возьмите 20 последних закрытых тикетов одной темы и склейте честный путь, включая тупики. Карточка «шара не открывается»: DNS, ping, Test-NetConnection 445, права, offline files. Не копируйте абстрактный «проверьте сеть». Имена: FILE01.contoso.example, VLAN20.
Для P1 держите runbook «нет AD» отдельно, короткий, с телефонами. Его место — и KB, и офлайн. После каждого реального P1 дополняйте карточку тем, что сработало, в тот же день, пока помните.
Метрика старта: 50% повторяющихся тикетов закрываются со ссылкой на KB id. Если ноль — карточки не ищутся или врут. Тогда чините заголовки языком пользователя («не открывается папка»), не «SMB negotiate failed».
Не создавайте раздел «Разное» на 200 ссылок. Лучше 20 живых, чем навигация, в которой тонут.
Как проверить, что проблема устранена
- Есть ≥20 карточек, у каждой дата < 12 месяцев или пометка stale.
- Новый сотрудник закрыл учебный тикет «шара не открывается» по статье, без звонка Ивану.
- Дежурный находит runbook P1 за минуту.
- Старая вики либо архив, либо редиректы на живые карточки — не два источника правды.
Метрика: повторные тикеты той же темы ссылаются на KB id.
Карточку без команды не публикуйте: даже «перезагрузить спулер» должна содержать Get-Service Spooler / Restart-Service на конкретном PRINT01 и проверку очереди. Иначе KB снова станет советом «попробуйте перезагрузить». Связывайте карточку с узлом CMDB, если процедура узловая, а не общедоменная.
Назначьте слот 45 минут в неделю «карточка из журнала»: Иван Петров или дежурный берёт повтор тикетов и пишет. Без слота в календаре база не появится, это не вопрос мотивации.
Если не помогло
- Никто не пишет: Иван Петров выделяет 2 часа в неделю «карточка из журнала», иначе не появится.
- Слишком длинно: режьте до шаблона.
- Пользовательская KB и админская смешаны: два пространства, общий индекс.
- Инструмент умер вместе с AD: PDF критичных 5 runbook в сейфе/облаке вне домена.
Профилактика
- Definition of done тикета: «ссылка на KB или причина почему новой нет».
- Квартальная чистка stale.
- Онбординг админа — прогон 10 карточек.
- Не копировать статьи с интернета без проверки на ваших версиях.
FAQ
20 — это потолок?
Нет, это старт. Следующие добавляйте по частоте. 1000 страниц «на будущее» не пишите.
Можно ли считать этот портал AAADMIN своей KB?
Как внешнюю справку — да. Внутренняя KB Contoso обязана содержать ваши имена узлов, VLAN, владельцев. Внешняя статья не знает FILE01.
Нужен ли модератор?
Да: Иван Петров или дежурный редактор. Иначе появятся две статьи «как сбросить пароль» с разными правилами.
Что с видео?
Допустимо как дополнение. Текстовые команды обязательны: видео не ищутся в 03:00 так же быстро.
Как быть с устаревшим Server 2012 в парке?
Пометка в карточке softwareVersions. Не смешивайте команды 2012 и 2022 без пометки.
Обязательно ли рецензирование второй парой глаз?
Для P1-runbook — да. Для «как добавить принтер» — желательно, не блокируйте публикацию на неделю.