Попробовать бесплатно

Новичок находит ответ сам: база знаний на первом экране проекта

Документация, регламенты и онбординг живут рядом с задачами и файлами. Ключевые разделы закреплены на главной проекта — их видно до того, как человек пойдёт спрашивать в чат.

бесплатный тариф — без лимита людейв реестре ПО Минцифры

Нам доверяют 55 202+ компаний

Что меняется после настройки

Онбординг вместо личных объяснений
Онбординг вместо личных объяснений

Новичку даётся ссылка на раздел «Старт», а не два часа звонка. Тимлид объясняет один раз — страницей.

Меньше повторяющихся вопросов в чатах
Меньше повторяющихся вопросов в чатах

Ответ на «где лежит», «как мы это делаем» и «какая версия финальная» находится поиском за секунды.

Знания не уходят вместе с человеком
Знания не уходят вместе с человеком

Договорённости и технические решения зафиксированы в проекте, а не в личных переписках и локальных файлах.

Один вход в документацию
Один вход в документацию

Главная проекта — точка входа: разделы на виду, файлы рядом, ссылки на задачи из текста.

Как это собрать в Shtab

детали каждого шага — в документации ↗

Во вкладке «Виды» внизу сайдбара нажмите «+ Создать» и заведите отдельное рабочее пространство под документацию: правила проекта, регламенты, онбординг. В настройках задайте название, видимость и оформление — чтобы раздел не путали с рабочими досками задач.

Смысл шага: знания живут рядом с задачами, а не в чужом облаке с отдельным логином. Искать их в другом сервисе не нужно.

Создание нового проекта ↗

Как это выглядит на практике

Команда Shtab

Например, представим продуктовую команду из 12 человек, которая каждые полтора-два месяца подключает подрядчика на фронтенд. Онбординг выглядел так: созвон с тимлидом на два часа, ссылки на пять чатов и обещание «спрашивай, если что». Через неделю подрядчик всё равно собирал релиз не тем способом, потому что инструкция была в сообщении от прошлого квартала.

Допустим, команда заводит пространство «База знаний» и пишет ровно семь страниц — те, что закрывают вопросы последней недели: «Старт для новичка», «Как мы релизим», «Доступы и окружения», «Договорённости с заказчиком», «Технические решения», «Кто за что отвечает», «Правила код-ревью». Макеты и договор подряда лежат в Файлах проекта, страницы только ссылаются на них. Все семь разделов закреплены на главной с обложками.

Что меняется в такой постановке: следующий подрядчик получает одну ссылку вместо созвона, а его вопросы попадают в комментарии к страницам — и сразу становится видно, какие два абзаца написаны непонятно. Тимлид переписывает их один раз, а не объясняет третьему человеку подряд.

Что изменилось после запуска базы знаний
Что изменилось после запуска базы знаний

Кому подходит — и когда не нужно

КОМУ ПОДХОДИТ
В проекте регулярно появляются новые люди: подрядчики, стажёры, переходы между командами
Документация размазана по чатам, личным папкам и вложениям в задачах
Одни и те же процессы объясняются голосом по кругу
Инструкция должна лежать рядом с задачами и файлами, а не в отдельном сервисе
КОГДА НЕ НУЖНО
Команда из 2–3 человек, вся база знаний — один закреплённый документ
Нужна публичная база для клиентов с индексацией в поиске: Страницы для внутренней работы
Требуется версионирование техдокументации с ветками и code review
Никто не готов взять владение разделами
Страницы, комментарии и блок Страниц на главной доступны во всех тарифах. В on-premise база знаний работает так же, лимиты задаёт ваша инфраструктура.

Из чего собирается решение

База знаний на СтраницахСоздавайте и веди базу знаний вашей компании на Страницах. Оформляйте документы и…Страницы на главнойДобавляйте нужные страницы на главную и быстро возвращайтесь к недавно созданным или просмотренным материалам.Добавление контента в редактореТекстовый редактор в Shtab поддерживает встраивание любого контента прямо в описания карточек или на Страницу. Вы…Файлы проектовСоздавайте отдельные хранилища для файлов и выбирайте удобный вид: список или плитку. Документы остаются упорядоченными и быстро…КомментарииКомментарии в задачах, страницах, проектах, целях и ленте новостей сохраняют обсуждения рядом с работой и помогают команде не терять…Обложки страницДобавляйте на страницу подходящую по смыслу обложку из предложенных стоковых картинок или загружайте собственное…

Что отслеживать

Время до первой самостоятельной задачи новичка
Сколько дней от старта до задачи, закрытой без подсказок. Хорошая база знаний сокращает срок в разы.
Повторяющиеся вопросы в чате
Считайте вопросы, ответ на которые уже есть в базе. Каждый такой — сигнал, что страницу не найти или её нет.
Дата последнего обновления ключевых разделов
Разделы, которые не правили полгода, читают с недоверием — и перестают читать вовсе.
Комментарии к страницам
Живые вопросы под текстом означают, что базой пользуются. Тишина при потоке вопросов в чате — что нет.

Частые ошибки и как их починить

Начните с 5–7 страниц, которые закрывают реальные вопросы недели. Остальное переносите по запросу — когда кто-то спросил, а ответа нет.

База знаний живёт не там, где её удобно писать, а там, где её случайно увидят. Если разделы не закреплены на главной проекта и не находятся поиском за секунды, они не существуют: спросить человека всегда быстрее, чем искать документ в другом сервисе.

Что это такое

База знаний проекта — это структурированный набор внутренних страниц, где зафиксировано то, что команда иначе объясняет голосом: как устроен процесс, где лежат финальные файлы, что обещано заказчику, с чего начинает новичок. Она живёт в том же пространстве, что задачи и файлы, и имеет одну точку входа — главную проекта.

Отличие от папки с документами: у каждой темы своя страница, у страницы — владелец, комментарии и видимая дата обновления. Материалы раскладываются по вложенной структуре и размечаются метками, а найти нужный раздел можно через глобальный поиск Shtab — по обновлению 2.8 он ищет страницы, задачи, комментарии и файлы не только по названиям, но и по содержимому.

Какую задачу закрывает

Знания вроде бы есть, но каждый раз добываются заново. Регламент лежит в чьём-то облаке, финальный макет — во вложении к сообщению от марта, договорённость с заказчиком — в переписке двух человек, один из которых уже в другом проекте. Новичка вводит в курс тимлид: два часа звонка, из которых половина повторяется для каждого следующего.

Дальше начинаются мелкие потери, которые никто не считает: «а какая версия финальная?», «мы точно так релизим?», «где брать доступы?». Каждый такой вопрос — переключение контекста у двух человек. А когда сотрудник уходит, вместе с ним уходит часть контекста проекта: он был не записан, он был в голове и в личных сообщениях.

Что помогает на практике

  • Называйте страницы от вопроса, а не от сущности: «Как мы релизим» вместо «Регламент №4». Человек ищет глаголом.
  • Начните с семи страниц и добавляйте новую только тогда, когда кто-то спросил, а ответа не нашлось.
  • В начале каждой страницы — владелец и дата последней правки. Это дешевле любого регламента об актуализации.
  • Ссылайтесь из текста на конкретные задачи: инструкция «как мы релизим» становится проверяемой, когда рядом пример релиза.
  • Договоритесь о правиле двух шагов: сначала поиск и база знаний, потом вопрос человеку — и сразу правка страницы, если ответа там не было.
  • Страницы, комментарии и блок Страниц на главной доступны во всех тарифах — отдельную подписку под базу знаний покупать не нужно.

Как адаптировать под свой отдел

Команда 5–15 человек. Достаточно одного пространства и 5–7 страниц; владелец всей базы — тимлид. Ревизию делают раз в квартал за полчаса: пройти по разделам, устаревшее отправить в архив.

Агентство или студия с подрядчиками. Отдельная ветка «Договорённости с заказчиком» по каждому клиенту и обязательный раздел «Старт для новичка» с доступами. Полезно держать шаблонное дерево страниц и копировать его на новый проект.

Крупная компания. База знаний на каждый проект плюс общий раздел с корпоративными регламентами; навигация держится на папках и метках, а владельцы разделов закрепляются письменно. Для on-premise-размещения база знаний работает в том же виде — лимиты задаёт ваша инфраструктура.

Как меняется настройка базы знаний в зависимости от размера команды
Как меняется настройка базы знаний в зависимости от размера команды

Частые вопросы

Не нашли ответ — спросите на живой демонстрации или напишите в поддержку.

Связанные решения

Соберите базу знаний проекта за один вечер

Заведите пространство под документацию, напишите семь страниц, которые закрывают вопросы этой недели, и закрепите их на главной проекта. Дальше база растёт по запросам команды.