Dokümantasyon
El kitabı yaşayan bir dokümandır. Bilgi güncelliğini kaybediyorsa, bir yerlerde süreç/ürün değişmiştir: güncellemek bir ekip sorumluluğudur.
Tek Kaynak (Single Source of Truth)
Aynı bilginin birden fazla kopyası zamanla çelişir. Bu yüzden navigasyon, sayfa içerikleri ve UI desenleri belirli dosyalarda tekilleştirilir.
| Ne? | Nerede? | Not |
|---|---|---|
| Sayfa rotaları | app/**/page.tsx | App Router yapısı |
| İçerik verisi | data/content/*.ts | ContentSection[] ile |
| Render katmanı | components/content/ContentRenderer.tsx | type switch burada |
| Navigasyon | lib/navigation.ts | Sidebar/Breadcrumb/Search buradan |
İçerik Yazma İpuçları
- Başlık hiyerarşisini koru (H1 sayfa başlığı, sonra H2/H3)
- Paragrafları kısa tut, madde işaretleriyle netleştir
- Kuralları örneklerle destekle (ne yapılır/ne yapılmaz)
- Tabloları karar/istisna/sorumlu gibi net alanlar için kullan
- Belirsiz kalan yerleri 'Sahip' / 'Güncelleme tarihi' gibi bilgilerle tamamla