Bilgi Tabanı
Denomas bilgi tabanı yönetimi — yapı, makale yazma rehberi, SSS yönetimi, içerik güncelleme süreci
Bilgi Tabanı
Sorumluluk
Bilgi tabanı yönetimi @destek-ekibi sorumluluğundadır. Teknik içerik doğrulaması ilgili ürün ekipleri tarafından yapılır.
Bilgi Tabanı Yapısı
| Parametre | Değer |
|---|
| URL | docs.denomas.com |
| Altyapı | Nextcloud + Markdown tabanlı statik site |
| Arama motoru | Elasticsearch tam metin arama |
| Diller | Türkçe (birincil), İngilizce |
| Erişim | Herkese açık (temel) + müşteri portalı (detaylı) |
Kategori Hiyerarşisi
docs.denomas.com/
├── kurulum/ # Ürün kurulum kılavuzları
│ ├── odoo/
│ ├── nextcloud/
│ ├── zabbix/
│ └── genel/
├── nasil-yapilir/ # Adım adım rehberler
│ ├── yonetim/
│ ├── entegrasyon/
│ └── ozellistirme/
├── sorun-giderme/ # Bilinen sorunlar ve çözümler
│ ├── performans/
│ ├── erisim/
│ └── entegrasyon/
├── api/ # REST API dokümantasyonu
├── en-iyi-uygulamalar/ # Best practices
├── surum-notlari/ # Changelog
└── sss/ # Sık sorulan sorular
Erişim Seviyeleri
| Seviye | İçerik | Hedef Kitle |
|---|
| Herkese açık | Temel kurulum, SSS, sürüm notları | Topluluk + potansiyel müşteriler |
| Müşteri | Detaylı rehberler, sorun giderme | Standard+ müşteriler |
| Premium | En iyi uygulamalar, mimari rehberler | Premium+ müşteriler |
| Dahili | İç süreçler, runbook'lar | Yalnızca Denomas ekibi |
Makale Yazma Rehberi
Makale Şablonu
Her makale aşağıdaki yapıyı takip eder:
| Bölüm | Açıklama | Zorunlu |
|---|
| Başlık | Açık, aranabilir başlık | Evet |
| Özet | 1-2 cümle açıklama | Evet |
| Ön koşullar | Gerekli bilgi veya yapılandırma | Hayır |
| Adımlar | Numaralı adımlar veya açıklama | Evet |
| Doğrulama | Sonucun nasıl doğrulanacağı | Evet |
| Sorun giderme | Olası hatalar ve çözümleri | Hayır |
| İlgili makaleler | Wiki-link ile bağlantılı içerikler | Evet |
Yazım Kuralları
| Kural | Açıklama |
|---|
| Dil | Sade, net Türkçe. Teknik terimlerde İngilizce kabul edilir |
| Cümle uzunluğu | Kısa ve net cümleler. Maksimum 25 kelime |
| Kod blokları | Tüm komutlar ve yapılandırmalar kod bloğunda |
| Ekran görüntüleri | Nextcloud'da saklanır, göreceli yol ile referans |
| Versiyon belirtme | Hangi ürün versiyonu için geçerli olduğu belirtilmeli |
| SSOT | Bilgiyi kopyalama, wiki-link ile referans ver |
Kalite Kontrol
| Kontrol | Sorumlu | Zamanlama |
|---|
| Teknik doğruluk | İlgili ürün ekibi | Yayın öncesi |
| Dil ve format | Teknik yazar | Yayın öncesi |
| Müşteri geri bildirimi | Destek ekibi | Sürekli |
| Güncellik kontrolü | İçerik sahibi | Çeyreklik |
Sık Sorulan Sorular (SSS) Yönetimi
SSS Oluşturma Süreci
| Kaynak | Açıklama | Tetikleyici |
|---|
| Destek biletleri | Sık tekrarlayan sorular | Aynı soru 3+ kez sorulduğunda |
| Müşteri geri bildirimi | Portal ve anket verileri | Bilgi tabanı arama başarısızlığı |
| Ürün güncellemeleri | Yeni özellik veya değişiklik | Her release sonrası |
| Satış ekibi | Satış sürecinde sık sorulan sorular | Haftalık sync toplantısı |
SSS Kategorileri
| Kategori | Örnek Sorular |
|---|
| Genel | Denomas nedir, hangi ürünleri sunuyor |
| Lisanslama | Lisans türleri, fiyatlandırma, yenileme |
| Kurulum | Sistem gereksinimleri, kurulum adımları |
| Entegrasyon | LDAP, SSO, API bağlantıları |
| Performans | Ölçekleme, optimizasyon |
| Güvenlik | Şifreleme, erişim kontrolü, GDPR |
| Destek | Bilet oluşturma, SLA bilgileri |
SSS Metrik Hedefleri
| Metrik | Hedef |
|---|
| SSS makale sayısı | 200+ |
| SSS çözüm oranı (bilet sapması) | %30 |
| Ortalama faydalılık puanı | >%80 olumlu |
İçerik Güncelleme Süreci
Tetikleyiciler
| Tetikleyici | Eylem | Süre |
|---|
| Ürün yeni sürüm yayını | İlgili tüm makaleler güncellenir | 5 iş günü |
| Müşteri geri bildirimi (hatalı içerik) | Düzeltme ve doğrulama | 2 iş günü |
| Çeyreklik gözden geçirme | Tüm makaleler taranır | Çeyreklik |
| Bilinen sorun çözümü | Sorun giderme makalesi güncellenir | 1 iş günü |
| 6 ay+ güncellenmemiş makale | İçerik sahibine bildirim | Otomatik |
Güncelleme İş Akışı
Tetikleyici → İçerik Sahibi Bildirimi → Güncelleme → Teknik Review → Yayın
| Adım | Sorumlu | Araç |
|---|
| Güncelleme talebi | Herhangi biri | GitLab issue |
| İçerik güncelleme | İçerik sahibi / teknik yazar | GitLab MR |
| Teknik doğrulama | İlgili ürün ekibi | GitLab review |
| Yayın | Teknik yazar | GitLab CI (otomatik deploy) |
İçerik Yaşam Döngüsü
| Durum | Açıklama |
|---|
| Taslak | Yazılıyor, henüz yayınlanmadı |
| İncelemede | Teknik ve editorial review bekliyor |
| Yayında | Aktif, müşteriler tarafından erişilebilir |
| Güncelleme Gerekli | Eski versiyon, güncelleme planlandı |
| Arşivlenmiş | Artık geçerli değil, arama sonuçlarından çıkarıldı |
İlgili Sayfalar
Geribildirim
Bu sayfa yararlı oldu mu?
Bu sayfa faydali oldu
Bu sayfa gelistirilmeli
