Базы знаний и задачники — итоги
Метаданные и форматы — конфигурации и данные, Данные и разметка.
Кратко — что стоит унести из раздела "Базы знаний и задачники". Если пункт кажется туманным — откройте указанную главу или оглавление.
FAQ — Часто задаваемые вопросы
Практика wiki, трекеров и онбординга — где хранить знания, как не превратить Jira в свалку и что делать, когда "инструкции никто не читает". Термины для самопроверки — в чек-листе.
Вопрос. Ответы разбросаны по чатам — каждый день одни и те же вопросы новичкам.
Ответ. После третьего повтора — страница в wiki с ссылкой в чат. Без habit "сначала поиск" база не оживёт. Подробнее здесь — Базы знаний в IT.
Вопрос. Confluence превратился в свалку — ничего не найти.
Ответ. Нужны владелец пространства, архив, шаблоны и правило "одна тема — одна страница". Без уборки любая wiki деградирует за год. Подробнее здесь — Организация внутренней Wiki.
Вопрос. Статья в wiki устарела, но в поиске первая — новички ломают prod.
Ответ. Banner "устарело", дата ревью, redirect на новую страницу. Критичные runbook'и — quarterly review в календаре команды. Подробнее здесь — Базы знаний в IT.
Вопрос. "Знание в голове у Пети" — Петя в отпуске, инцидент.
Ответ. Bus factor: pairing + запись runbook до отпуска. Если процесс не работает без одного человека — это риск, а не героизм. Подробнее здесь — Базы знаний в IT.
Вопрос. Jira vs wiki — куда писать решение по архитектуре?
Ответ. Решение и контекст — wiki/ADR, в задаче — ссылка и критерии приёмки. Jira плохо хранит длинные знания и версионность текста. Подробнее здесь — Базы знаний в IT, Системы управления задачами.
Вопрос. Задача без описания — только заголовок "починить баг".
Ответ. Минимум: шаги воспроизведения, ожидание, факт, среда. Шаблон бага в трекере экономит часы переписки. Подробнее здесь — Системы управления задачами.
Вопрос. Баг vs задача vs epic — в трекере всё под одним типом.
Ответ. Разные типы дают разную аналитику и SLA. Смешение ломает отчёты и приоритеты поддержки. Подробнее здесь — Системы управления задачами.
Вопрос. Комментарии в задаче — простыня на 200 сообщений, суть потеряна.
Ответ. Итог решения — в описание или wiki; в комментариях — хронология. Периодически "сжимайте" в summary. Подробнее здесь — Системы управления задачами.
Вопрос. Техдолг завели как epic, но он вечно внизу бэклога.
Ответ. Свяжите долг с риском/стоимостью задержки, выделите % capacity или отдельный kanban-поток. Без видимости метрик долг игнорируют. Подробнее здесь — Системы управления задачами.
Вопрос. Приоритет "Highest" у половины задач — как фильтровать?
Ответ. Введите правило одного critical или WSJF; иначе приоритет бессмыслен. Ретро на инфляцию "срочности". Подробнее здесь — Системы управления задачами.
Вопрос. Подзадачи размножились — родительская задача не двигается.
Ответ. Декомпозиция ради параллельной работы и оценки, не ради галочки. Если подзадач >7 и нет владельцев — пересоберите story. Подробнее здесь — Системы управления задачами.
Вопрос. Зависимость между командами в Jira — блокер висит неделями.
Ответ. Явный владелец блокера, дата эскалации, видимость на общем board. "Blocked" без имени — мёртвый статус. Подробнее здесь — Системы управления задачами.
Вопрос. Теги в задачах — каждый пишет по-своему, фильтры бесполезны.
Ответ. Controlled vocabulary: список допустимых labels в wiki, lint в шаблоне задачи. Подробнее здесь — Системы управления задачами.
Вопрос. Онбординг — "читай wiki" на 500 страниц.
Ответ. Сделайте маршрут "первые 5 дней": доступы, сборка, деплой, контакты, одна задача end-to-end. Подробнее здесь — Базы знаний в IT.
Вопрос. Внешняя база для клиентов и внутренняя wiki — дублируют друг друга.
Ответ. Публичная — без секретов и внутренних костылей; внутренняя — полная. Sync или single-source с фильтром экспорта. Подробнее здесь — Базы знаний в IT.
Вопрос. Support шлёт ссылки на wiki, клиенты не находят ответ — в чём дело?
Ответ. Поиск, заголовки под формулировки пользователя, не жаргон dev. FAQ на основе топ-10 тикетов. Подробнее здесь — Базы знаний в IT, Техподдержка.
Вопрос. Две команды завели две wiki с одной темой — спор, где правда.
Ответ. Назначьте owner домена и canonical URL; вторую страницу архивируют с redirect. Дубли — главный враг доверия к KB. Подробнее здесь — Организация внутренней Wiki.
Вопрос. Docusaurus / статический сайт vs Confluence — что выбрать?
Ответ. Docs-as-code (Git, review) — для технической doc рядом с кодом; Confluence — для живых обсуждений и бизнес-регламентов. Часто оба с перекрёстными ссылками. Подробнее здесь — Docusaurus.
Вопрос. Миграция со старых Word-инструкций в wiki — с чего начать?
Ответ. Топ-20 частых процедур, не "всё сразу". Каждый перенос — chance упростить и проверить на staging. Подробнее здесь — Базы знаний в IT.
Вопрос. Секреты в wiki "для удобства" — пароли от staging в открытой странице.
Ответ. Секреты — в vault/менеджер паролей, в wiki только ссылка и процедура ротации. Подробнее здесь — Базы знаний в IT.
Вопрос. Команда не пишет в wiki — "нет времени".
Ответ. Включите doc в DoD, выделите время на ревью статей, поощряйте ссылки вместо личных ответов. Культура важнее инструмента. Подробнее здесь — Организация внутренней Wiki.
Вопрос. Задачник интегрирован с Git — PR без номера тикета rejected. Разработчики бунтуют.
Ответ. Правило traceability снижает потерянные фиксы; смягчите для chore/docs, но для фич и багов — жёстко. Объясните зачем, не только "так сказали". Подробнее здесь — Системы управления задачами.
Вопрос. Автосоздание задач из алертов — flood тикетами.
Ответ. Группировка, threshold, dedup и on-call runbook до тикета. Иначе трекер становится мусорной корзиной мониторинга. Подробнее здесь — Системы управления задачами.
Вопрос. Распределённая команда — wiki только на русском, часть команды lost.
Ответ. Критичные runbook'и — на рабочем языке команды или bilingual summary в шапке. Подробнее здесь — Базы знаний в IT.
Вопрос. Чек-лист самопроверки в энциклопедии — как им пользоваться в обучении?
Ответ. После раздела — случайный вопрос, закрытая книга, объяснение вслух; слабые темы — ссылка на главу, не зубрёжка итогов. Подробнее здесь — Базы знаний в IT.
Вопрос. Задачник и KPI "закрытых тикетов" — support закрывает без решения.
Ответ. Метрика должна включать reopen rate и время до решения, не только count closed. Gaming метрик ломает доверие. Подробнее здесь — Системы управления задачами.
Вопрос. Хочу учиться на задачах энциклопедии — где практика рядом с теорией?
Ответ. Связывайте статью раздела с тикетом/лабой в своём трекере и фиксируйте вывод в личной wiki; см. также практические материалы вроде Основы JavaScript. Подробнее здесь — Базы знаний в IT.
Ниже — формулировки, которые часто вводят в Google и Яндексе; короткий ответ и ссылка на материал раздела.
Вопрос. База знаний компании — что это и зачем?
Ответ. Централизованное хранилище инструкций, решений и регламентов с поиском — меньше "дёргания" коллег. Подробнее здесь — Базы знаний в IT.
Вопрос. Confluence wiki — как использовать в команде?
Ответ. Пространства по доменам, шаблоны статей, owner и ревью — не свалка заметок. Подробнее здесь — Организация внутренней Wiki.
Вопрос. Jira — для чего используют в разработке?
Ответ. Трекинг задач, багов, спринтов, связь с Git и отчётность по потоку. Подробнее здесь — Системы управления задачами.
Вопрос. Баг-трекер — что это?
Ответ. Система учёта дефектов: воспроизведение, приоритет, статус, связь с релизом. Подробнее здесь — Системы управления задачами.
Вопрос. Чем задача (task) отличается от бага (bug)?
Ответ. Task — новая работа/фича; bug — расхождение с ожидаемым поведением. Разные SLA и метрики. Подробнее здесь — Системы управления задачами.
Вопрос. Acceptance criteria в Jira — как писать?
Ответ. Проверяемые условия "готово, когда…" в описании story, не в комментариях. Подробнее здесь — Системы управления задачами.
Вопрос. Wiki в IT — что туда кладут?
Ответ. Runbook'и, ADR, онбординг, FAQ support, архитектурные схемы — всё, что переживёт закрытие тикета. Подробнее здесь — Организация внутренней Wiki.
Вопрос. Runbook в базе знаний — пример содержания?
Ответ. Симптом → диагностика → команды → эскалация → откат. Подробнее здесь — Базы знаний в IT.
Вопрос. Jira или Trello — что выбрать для стартапа?
Ответ. Trello — простой kanban; Jira — когда нужны workflow, отчёты и масштаб. Подробнее здесь — Системы управления задачами.
Вопрос. Как приоритизировать product backlog?
Ответ. Ценность, риск, зависимости — методы WSJF, MoSCoW; решает Product Owner. Подробнее здесь — Системы управления задачами.
Вопрос. Epic, story, task — иерархия в Agile?
Ответ. Epic — крупная цель; story — ценность для пользователя; task — технический шаг. Подробнее здесь — Системы управления задачами.
Вопрос. База знаний для онбординга нового сотрудника — что включить?
Ответ. Доступы, сборка, первый тикет, контакты, глоссарий, ссылки на регламенты. Подробнее здесь — Базы знаний в IT.
Вопрос. Knowledge base и documentation — одно и то же?
Ответ. KB шире: runbook, FAQ, уроки инцидентов; formal doc — ТЗ и руководства по ГОСТ. Пересекаются, но цели разные. Подробнее здесь — Базы знаний в IT.
Вопрос. Как организовать корпоративную wiki с нуля?
Ответ. Цели, структура, шаблоны, owner, топ-20 статей из чатов support — не "перенести всё". Подробнее здесь — Организация внутренней Wiki.
Вопрос. YouTrack vs Jira — в чём разница?
Ответ. Оба — issue tracker; выбор по экосистеме, цене, workflow и привычкам команды. Подробнее здесь — Системы управления задачами.
Вопрос. Sprint backlog — что это?
Ответ. Подмножество product backlog, выбранное на спринт с commitment команды. Подробнее здесь — Системы управления задачами.
Вопрос. Как декомпозировать задачу разработки?
Ответ. До шагов ≤1–2 дня с ясным результатом и без скрытых зависимостей. Подробнее здесь — Системы управления задачами.
Вопрос. Устаревшая статья в wiki — как пометить?
Ответ. Banner, дата review, ссылка на новую версию или архив. Подробнее здесь — Организация внутренней Wiki.
Вопрос. ITSM knowledge base — что это?
Ответ. KB в связке с Service Desk: статьи закрывают типовые тикеты, метрики deflection. Подробнее здесь — Базы знаний в IT, Техподдержка, ITSM.
Вопрос. Notion или Confluence для документации команды?
Ответ. Notion — гибкость и стартапы; Confluence — enterprise, Jira, права. Подробнее здесь — Организация внутренней Wiki.
Вопрос. Шаблон задачи в Jira — зачем?
Ответ. Единые поля (AC, среда, ссылки) — меньше уточняющих вопросов и лучше отчёты. Подробнее здесь — Системы управления задачами.
Вопрос. Docusaurus для документации — когда подходит?
Ответ. Публичная или внутренняя docs-as-code с версиями, поиском и MDX — как у энциклопедии. Подробнее здесь — Docusaurus.
Что запомнить
Основные категории:
- первое;
- второе;
- третье;
- четвёртое.
Три основных правила использования:
- Первое.
- Второе.
- Третье.
Три фундаментальных момента:
- первый.
- второй.
- третий.
Куда идти дальше
| Тема | Раздел |
|---|---|
| "Техническая поддержка — о разделе" | "Техническая поддержка — о разделе" |
| "Техническое письмо — о разделе" | "Техническое письмо — о разделе" |
Проверьте себя: Чек-лист самопроверки.