https://handbook.orneksirket.com/tags/documentation/Recent content in Documentation on Denomas HandbookHugotrhttps://handbook.orneksirket.com/support/knowledge-base/Mon, 01 Jan 0001 00:00:00 +0000https://handbook.orneksirket.com/support/knowledge-base/<h1 id="bilgi-tabanı">Bilgi Tabanı</h1> <div class="td-alert td-alert--md alert alert-dse" role="alert"><div class="td-alert-heading alert-heading" role="heading">Sorumluluk</div> <div class="td-alert-body"> <p>Bilgi tabanı yönetimi <strong>@destek-ekibi</strong> sorumluluğundadır. Teknik içerik doğrulaması ilgili ürün ekipleri tarafından yapılır.</p> </div> </div> <h2 id="bilgi-tabanı-yapısı">Bilgi Tabanı Yapısı</h2> <h3 id="platform">Platform</h3> <table> <thead> <tr> <th>Parametre</th> <th>Değer</th> </tr> </thead> <tbody> <tr> <td><strong>URL</strong></td> <td><code>docs.denomas.com</code></td> </tr> <tr> <td><strong>Altyapı</strong></td> <td>Nextcloud + Markdown tabanlı statik site</td> </tr> <tr> <td><strong>Arama motoru</strong></td> <td>Elasticsearch tam metin arama</td> </tr> <tr> <td><strong>Diller</strong></td> <td>Türkçe (birincil), İngilizce</td> </tr> <tr> <td><strong>Erişim</strong></td> <td>Herkese açık (temel) + müşteri portalı (detaylı)</td> </tr> </tbody> </table> <h3 id="kategori-hiyerarşisi">Kategori Hiyerarşisi</h3> <pre tabindex="0"><code>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 </code></pre><h3 id="erişim-seviyeleri">Erişim Seviyeleri</h3> <table> <thead> <tr> <th>Seviye</th> <th>İçerik</th> <th>Hedef Kitle</th> </tr> </thead> <tbody> <tr> <td><strong>Herkese açık</strong></td> <td>Temel kurulum, SSS, sürüm notları</td> <td>Topluluk + potansiyel müşteriler</td> </tr> <tr> <td><strong>Müşteri</strong></td> <td>Detaylı rehberler, sorun giderme</td> <td>Standard+ müşteriler</td> </tr> <tr> <td><strong>Premium</strong></td> <td>En iyi uygulamalar, mimari rehberler</td> <td>Premium+ müşteriler</td> </tr> <tr> <td><strong>Dahili</strong></td> <td>İç süreçler, runbook'lar</td> <td>Yalnızca Denomas ekibi</td> </tr> </tbody> </table> <h2 id="makale-yazma-rehberi">Makale Yazma Rehberi</h2> <h3 id="makale-şablonu">Makale Şablonu</h3> <p>Her makale aşağıdaki yapıyı takip eder:</p>https://handbook.orneksirket.com/hiring/job-families/technical-writer/Mon, 01 Jan 0001 00:00:00 +0000https://handbook.orneksirket.com/hiring/job-families/technical-writer/<h1 id="technical-writer-teknik-yazar">Technical Writer (Teknik Yazar)</h1> <p>Teknik yazarlar, Denomas ürünlerinin ve iç süreçlerinin dokümantasyonunu oluşturur ve yönetir. Handbook, API referansları, kullanım rehberleri ve sürüm notlarından sorumludur.</p> <hr> <h2 id="kullanılan-araçlar">Kullanılan Araçlar</h2> <table> <thead> <tr> <th>Araç</th> <th>Kullanım Alanı</th> </tr> </thead> <tbody> <tr> <td>Markdown</td> <td>Doküman yazım formatı</td> </tr> <tr> <td>Git / GitLab</td> <td>Versiyon kontrolü ve iş birliği</td> </tr> <tr> <td>Hugo / MkDocs</td> <td>Statik site oluşturma</td> </tr> <tr> <td>Figma</td> <td>Diyagram ve ekran görüntüsü düzenleme</td> </tr> <tr> <td>Obsidian</td> <td>Handbook yönetimi</td> </tr> <tr> <td>Vale / markdownlint</td> <td>Yazım ve biçim kontrolü</td> </tr> </tbody> </table> <hr> <h2 id="kariyer-seviyeleri-ve-denomas-yetkinlik-çerçevesi-gereksinimleri">Kariyer Seviyeleri ve Denomas Yetkinlik Çerçevesi Gereksinimleri</h2> <h3 id="junior-technical-writer--yetkinlik-seviyesi-2">Junior Technical Writer — Yetkinlik Seviyesi 2</h3> <p><strong>Denomas Yetkinlik Çerçevesi Gereksinimleri:</strong></p>https://handbook.orneksirket.com/product/urun-dokumantasyonu/Mon, 01 Jan 0001 00:00:00 +0000https://handbook.orneksirket.com/product/urun-dokumantasyonu/<h1 id="ürün-dokümantasyonu">Ürün Dokümantasyonu</h1> <p>Bu sayfa, Denomas ürünlerinin dokümantasyon türlerini, docs-as-code yaklaşımını, versiyon yönetimini ve çeviri sürecini tanımlar.</p> <hr> <h2 id="doküman-türleri">Doküman Türleri</h2> <table> <thead> <tr> <th>Tür</th> <th>Hedef Kitle</th> <th>İçerik</th> <th>Güncelleme Sıklığı</th> </tr> </thead> <tbody> <tr> <td><strong>API Referansı</strong></td> <td>Geliştirici</td> <td>Endpoint tanımları, parametre açıklamaları, örnek istekler/yanıtlar</td> <td>Her sürümde</td> </tr> <tr> <td><strong>Kullanım Rehberi</strong></td> <td>Son kullanıcı</td> <td>Adım adım görev tamamlama yönergeleri</td> <td>Özellik değişikliğinde</td> </tr> <tr> <td><strong>Hızlı Başlangıç</strong></td> <td>Yeni kullanıcı</td> <td>İlk kurulum ve temel kullanım (15 dakika hedefi)</td> <td>Büyük sürümlerde</td> </tr> <tr> <td><strong>Mimari Dokümanı</strong></td> <td>Mühendis, mimar</td> <td>Sistem mimarisi, veri akışı, bileşen ilişkileri</td> <td>Çeyreklik</td> </tr> <tr> <td><strong>Sürüm Notları</strong></td> <td>Tüm kullanıcılar</td> <td>Yeni özellikler, düzeltmeler, kırılma değişiklikleri</td> <td>Her sürümde</td> </tr> <tr> <td><strong>Sorun Giderme</strong></td> <td>Destek, son kullanıcı</td> <td>Bilinen sorunlar ve çözümleri</td> <td>Sürekli</td> </tr> </tbody> </table> <div class="td-alert td-alert--md alert alert-note" role="alert"><div class="td-alert-heading alert-heading" role="heading">Doküman Sorumluluğu</div> <div class="td-alert-body"> <p>API referansı ve mimari doküman: @muhendislik-ekibi. Kullanım rehberi ve hızlı başlangıç: @urun-ekibi. Sürüm notları: ortak sorumluluk.</p>