Что прислать перед встречей

Перед консультацией не нужно готовить презентацию или структурировать мысли «по правилам». Достаточно прислать то, что уже есть, — в любом виде. Ниже — список того, что помогает войти в контекст до встречи.

Универсальное: подходит для любой темы

Эти материалы полезны вне зависимости от того, по какому направлению вы записались на консультацию.

• Краткое описание продукта или сервиса: что это, для кого, на каком этапе разработки.
• Основная задача, с которой вы пришли: что именно хотите решить или прояснить.
• Что уже пробовали или что есть сейчас — даже если считаете это «не тем».
• Стек: какие инструменты, платформы или системы уже используются (Confluence, Notion, GitHub, Jira и т.д.).
• Примерный размер команды и кто работает с документацией или базой знаний.

Этого уже достаточно, чтобы встреча прошла предметно.

---

База знаний: аудит и развитие

Если вы хотите разобраться с состоянием существующей базы знаний или понять, как её развивать, пришлите:

• Ссылку на базу знаний или скриншоты структуры верхнего уровня (разделы, пространства).
• Примерное количество страниц или статей.
• Как давно её ведут и кто отвечает за актуальность.
• Основные жалобы команды: «не можем найти», «всё устарело», «никто не пользуется» и т.п.

Документация: создание и техническая документация

Если нужна помощь с документацией для продукта, сервиса или внутренних процессов:

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

DocOps и автоматизация

Если интересует выстраивание процессов, CI/CD для документации или автоматизация рутины:

• Где сейчас хранится документация и как она публикуется.
• Что хотелось бы автоматизировать: генерацию, проверку, публикацию, отчёты.
• Используете ли Git, CI/CD-системы (GitHub Actions, GitLab CI и др.).
• Есть ли технический специалист в команде, готовый поддерживать пайплайн.

Документация для API

Если нужно навести порядок в API-документации или запустить её с нуля:

• Ссылка на текущую документацию или OpenAPI-спецификацию (если есть).
• Кто основная аудитория: внешние разработчики, партнёры или внутренняя команда.
• Есть ли сейчас жалобы от потребителей API на непонятность или неполноту.
• Планируется ли публичный Developer Portal или достаточно внутреннего справочника.

RAG и AI-бот по базе знаний

Если рассматриваете создание чат-бота или RAG-поиска по внутренним материалам:

• Какую задачу должен решать бот: поддержка сотрудников, онбординг, самообслуживание клиентов.
• Источники данных: Confluence, Notion, Markdown-репозиторий, что-то другое.
• Есть ли требования к безопасности данных и разграничению доступа.
• Рассматривались ли уже какие-то инструменты или платформы.
• Как будет оцениваться результат: что значит «работает хорошо» для вашей команды.

---

Что не нужно готовить специально

Не нужно структурировать материалы «красиво» — принимаем всё как есть: ссылки, скриншоты, голосовые сообщения, таблицы. Если чего-то нет, просто напишите об этом: отсутствие материалов тоже информация.

Присылайте всё на почту или в мессенджер при записи на встречу. Если используете форму на сайте — поле «Сообщение» подходит для короткого описания, а материалы можно прислать отдельно после подтверждения.

Записаться на консультацию