commit

REVIEW.md

@@ -0,0 +1,89 @@
+# 📋 Review workflow — Oponentura a kontrola obsahu
+
+## Proces
+
+```
+Draft ──→ Self-review ──→ Peer review ──→ Approval ──→ Merged
+  ↑                                                    │
+  └────────────── Feedback loop ───────────────────────┘
+```
+
+## Fáze
+
+### 1. Draft
+
+- Autor vytvoří nový obsah / upraví existující
+- Označí soubory jako `[draft]` v poznámce commit message
+- Cíl: zachytit myšlenky, strukturu a fakta
+
+### 2. Self-review (autor)
+
+- [ ] Je obsah **srozumitelný**? Pochopí to junior?
+- [ ] Jsou **fakta správná**? Ověřit proti sources / oficiální dokumentaci
+- [ ] Jsou uvedeny **zdroje**? (odkazy v `sources/`)
+- [ ] Je **struktura konzistentní** se zbytkem KB?
+- [ ] Jsou **zkratky** vysvětleny?
+- [ ] **Pravopis a gramatika**
+- [ ] Odpovídá **tón** — faktický, bez subjektivních názorů
+- [ ] Obsahuje **actionable best practices**, nejen teorii
+
+### 3. Peer review (kolega / oponent)
+
+- Autor zažádá o review (PR / issue / @mention)
+- Oponent kontroluje:
+  - **Odborná správnost** — jsou data a koncepty validní?
+  - **Úplnost** — není něco důležitého vynecháno?
+  - **Nestrannost** — neupřednostňuje jeden vendor bezdůvodně?
+  - **Aktuálnost** — nejsou informace zastaralé?
+
+**Review template:**
+
+```
+## Review: [název souboru]
+
+### Odborná správnost
+- [ ] Fakta jsou správná
+- [ ] Doporučení jsou vhodná
+- [ ] Uvedené zdroje jsou relevantní
+
+### Struktura a forma
+- [ ] Logické členění
+- [ ] Konzistentní formátování
+- [ ] Jazyk je srozumitelný
+
+### Připomínky
+- [ ] [připomínka 1]
+- [ ] [připomínka 2]
+
+### Verdikt
+- [ ] Schvaluji
+- [ ] Schvaluji s výhradami (viz připomínky)
+- [ ] Zamítnuto (důvod: …)
+```
+
+### 4. Approval
+
+- Schvaluje: autor + minimálně 1 peer reviewer
+- Po schválení se obsah považuje za `[done]`
+- Změny po schválení vyžadují nový review cyklus
+
+### 5. Merged / Published
+
+- Obsah je považován za aktuální a důvěryhodný
+- Pokud je zdroj označen `[done]` v `sources/`, je to potvrzení zpracování
+
+## Stavy souborů
+
+| Status | Význam |
+|--------|--------|
+| `[draft]` | Rozpracováno, neprošlo review |
+| `[in-review]` | Probíhá peer review |
+| `[done]` | Schváleno, aktuální |
+| `[outdated]` | Zastaralé, čeká na revizi |
+| `[deprecated]` | Nahrazeno jiným dokumentem |
+
+## Pravidelná revize
+
+- **Kvartálně** — kontrola aktuálnosti celé KB
+- **Trigger** — nová verze nástroje, změna architektury, EOL technologie
+- Každý soubor by měl mít v patičce **datum poslední revize**