Что такое Confluence?

Confluence: Система управления знаниями и документацией

Confluence — это облачная платформа для создания, организации и обмена документацией, разработанная Atlassian. Это центральный репозиторий знаний организации.

Что это такое

Confluence — это wiki-подобная система, которая объединяет:

• Документацию — требования, API-docs, runbooks
• Базу знаний — best practices, решённые проблемы
• Совместную работу — comments, @mentions, версионирование
• Стратегические материалы — roadmaps, decisions, OKR

Это не просто блокнот, а полнофункциональная система управления информацией организации.

Структура Confluence

Confluence организуется иерархически:

1. Spaces

• Основная единица организации
• Каждая команда может иметь свой Space (Engineering, Product, HR)
• Разделение доступов по пространствам

2. Pages (страницы)

• Документы в пространстве
• Могут быть вложены иерархически (родитель-дети)
• Поддержка rich-text редактора

3. Macros (расширения)

• Встроенные компоненты для динамического контента
• Таблицы, графики, код-блоки, встроенные диаграммы
• Интеграция с Jira, статус-макросы

4. Templates (шаблоны)

• Стандартизованные форматы документов
• Meeting notes, Decision records, Runbooks
• Ускоряют процесс документирования

Практическое использование BA в Confluence

Требования и спецификации:

Spaces:
├── Product Requirements
│   ├── Feature: User Authentication
│   ├── Feature: Payment Integration
│   └── Roadmap 2024
├── Technical Specs
│   ├── API Documentation
│   ├── Database Schema
│   └── Architecture Decisions
└── Processes
    ├── QA Guidelines
    ├── Release Checklist
    └── Incident Management

Decision Records (ADRs): Важ для BA хранить в Confluence архитектурные и бизнес решения с обоснованием:

• Почему выбран этот подход?
• Кто принимал решение?
• Когда оно было принято?
• Какие альтернативы рассматривались?

User Stories и Acceptance Criteria: Документация требований в формате, понятном для разработчиков:

As a [User Type]
I want [Functionality]
So that [Business Value]

Acceptance Criteria:
- [ ] User can do X
- [ ] System validates Y
- [ ] Error handling for Z

Интеграция с другими инструментами

Jira:

• Встроенные macros для отображения задач из Jira
• Синхронизация статусов
• Ссылки между требованиями и разработкой

Slack:

• Уведомления об обновлениях документов
• Быстрое сохранение Slack-сообщений в Confluence
• Поиск документов прямо из Slack

Google Workspace / Office 365:

• Встраивание таблиц и презентаций
• Совместное редактирование

Ключевые возможности Confluence

Версионирование и история

• Каждое изменение отслеживается
• Можно вернуться к старой версии
• Видна история вех (кто, когда, что изменил)

Поиск и навигация

• Мощный полнотекстовый поиск
• Фильтры по метаданным
• Связанные страницы ("See also")

Права доступа

• Разделение по пространствам и страницам
• Ограничение для конфиденциальных данных
• Audit log для compliance

Комментарии и обсуждения

• Inline comments для обсуждения деталей
• Thread-based диалоги
• @mentions для привлечения внимания

Почему Confluence критичен для BA

✓ Single source of truth — одно место для всех требований ✓ Трейсируемость — история изменений требований ✓ Асинхронная коммуникация — документ читают в удобное время ✓ Масштабируемость — знания не теряются при смене людей ✓ Интеграция — подключается к инструментам разработки ✓ Compliance — архив всех решений и версий

Лучшие практики

1. Держи Confluence актуальным — отчёты больше не нужны = сними их
2. Используй шаблоны — единообразная структура
3. Линкуй между документами — создавай граф знаний
4. Архивируй старые материалы — не удаляй, но помечай как obsolete
5. Вовлекай команду — документирование это сообщество

Confluence — это не просто инструмент, это организационная память, которая делает BA полезнее и команду эффективнее.