Confluence

1. Co je Confluence?

Confluence je znalostní báze a dokumentační nástroj od společnosti :contentReference[oaicite:0]{index=0}, který slouží týmům ke sdílení dokumentace, požadavků, technických rozhodnutí a interních procesů. Používá se ve vývoji software, QA, DevOps, supportu i managementu. V QA je důležitý hlavně pro zachování kontextu, transparentnost procesů a dlouhodobou dohledatelnost informací.

Confluence funguje jako centrální místo pro:

• technickou dokumentaci,
• testovací strategie,
• release dokumentaci,
• meeting notes,
• runbooky a incident management,
• onboarding nových členů týmu,
• procesní dokumentaci,
• API dokumentaci,
• knowledge base pro support.

Klíčové vlastnosti Confluence:

• Dokumentace požadavků: byznys pravidla, acceptance criteria, user flow diagramy, edge cases, API kontrakty, validace formulářů nebo integrační scénáře.
• Meeting notes: refinement, sprint planning, retro, release readiness, incident review, architektonická rozhodnutí a follow-up úkoly.
• QA pages: test strategy, regression scope, smoke checklist, test matrix, device matrix, release checklist, exploratory testing notes a defect analysis.
• Propojení s Jira: vložení Jira ticketů, filtrů, dashboardů, sprint reportů nebo automaticky aktualizovaných tabulek.
• Historie změn: dohledatelné úpravy, audit změn, možnost porovnání verzí dokumentu a návratu ke starší verzi.
• Šablony: předpřipravené template pro retrospektivy, meeting notes, postmortem, release notes nebo test plans.
• Komentáře a collaboration: inline komentáře, mention uživatelů, review dokumentace a týmová spolupráce v reálném čase.
• Vyhledávání: fulltextové hledání přes celý workspace, tagování dokumentů a kategorizace podle týmů nebo projektů.
• Permission management: omezení přístupu na úroveň spaces, stránek nebo konkrétních týmů.
• Integrace: propojení s Jira, GitLab, Slack, Microsoft Teams, CI/CD nástroji nebo monitoring systémy.

2. Struktura Confluence

Confluence je rozdělený do tzv. Spaces (prostorů), které reprezentují například projekt, tým nebo oddělení.

Příklad struktury:

Company Space
 ├── Engineering
 │    ├── Backend
 │    ├── Mobile
 │    ├── QA
 │    └── DevOps
 │
 ├── Product
 ├── Support
 └── Operations

Každý Space obsahuje jednotlivé stránky (Pages), které mohou být hierarchicky organizované.

Typické QA stránky:

• Test Strategy
• Regression Checklist
• Release Readiness
• Known Issues
• Environment Configuration
• Device Matrix
• Test Data Rules
• Automation Documentation
• Incident Reports
• Postmortem Analysis

3. Confluence v QA

Tester může v Confluence udržovat testovací strategii pro mobilní aplikaci, seznam podporovaných zařízení, known issues, release checklist, pravidla pro testovací data nebo onboarding dokumentaci pro nové QA členy.

U agilních týmů a rychlých sprintů pomáhá mít jedno centrální místo, kam se celý tým pravidelně vrací. Díky tomu nejsou informace roztroušené v chatu, e-mailech nebo pouze v hlavách jednotlivých lidí.

Co QA tým typicky dokumentuje:

• testovací scénáře,
• scope regresního testování,
• release checklisty,
• testovací data a jejich omezení,
• rizikové oblasti systému,
• known issues,
• device coverage,
• monitoring produkčních incidentů,
• bug triage pravidla,
• root cause analýzy.

Ukázka QA stránky:

Page: Wallet payment QA checklist

Scope:
- Wallet onboarding
- Payment authorization
- Transaction history
- Notifications
- Refunds

Devices:
- iPhone iOS latest
- Android latest
- Small screen Android

Risks:
- Duplicate payment
- Pending state shown as success
- Missing notification
- Provider timeout

Regression:
- Existing cards still usable
- Saved payment methods visible
- Retry flow after failure
- Push notifications delivered

Test data:
- Valid VISA
- Expired card
- 3DS required card
- Blocked user account

Monitoring:
- Payment provider latency
- Failed transaction rate
- Notification delivery status

4. Výhody Confluence pro QA

• Centralizace informací: všechny důležité informace na jednom místě.
• Transparentnost: tým vidí aktuální procesy, rozhodnutí i známé problémy.
• Lepší onboarding: nový tester se rychleji zorientuje v projektu.
• Dohledatelnost: historické změny a rozhodnutí jsou archivované.
• Lepší komunikace: méně závislosti na ústním předávání informací.
• Podpora auditu: vhodné pro enterprise projekty nebo regulované prostředí.
• Snadná údržba: dokumenty lze rychle aktualizovat bez složitých release procesů.

5. Nevýhody a časté problémy

• zastaralá dokumentace,
• duplicitní stránky,
• nejasné ownership dokumentů,
• příliš dlouhé nebo nepřehledné stránky,
• informace rozeseté mezi více spaces,
• neaktuální release checklisty,
• copy-paste dokumentace bez údržby.

Doporučení:

• udržovat dokumentaci krátkou a přehlednou,
• pravidelně dělat cleanup zastaralých stránek,
• mít jasného ownera dokumentace,
• používat šablony,
• linkovat Jira tickety místo kopírování textu,
• oddělovat stabilní procesy od dočasných poznámek.

6. Nejčastější použití Confluence v IT

• QA: test plans, regression checklisty, release notes.
• Development: technická dokumentace, API specs.
• DevOps: runbooky, deployment postupy.
• Support: troubleshooting knowledge base.
• Product: roadmapy, business requirements.
• Management: meeting notes, procesní dokumentace.

7. Shrnutí

Confluence je jeden z nejpoužívanějších dokumentačních nástrojů v IT. Pro QA týmy představuje centrální místo pro testovací strategie, release procesy, known issues, checklisty a sdílení znalostí. Správně vedená Confluence dokumentace výrazně zlepšuje komunikaci, stabilitu procesů a efektivitu celého týmu.