Hangi .NET Viewer Lisansı Gerçekten İhtiyacınız? Tam Bir Kılavuz
Hangi .NET Viewer Lisansı Gerçekten İhtiyacınız? Tam Bir Kılavuz
Temiz, versiyon‑kontrollü bir API'yi nihayet yayınladığınızda, bir sonraki engel genellikle dokümantasyon görüntüleyicisi olur. Özellik seti genellikle tam isabetlidir, ancak lisanslama modeli ekipler, ortaklar ya da müşteriler arasında benimsenmeyi yavaşlatan gizli bir sorun olabilir.
Bu makalede, Doconut .NET dokümantasyon görüntüleyicisi için üç temel lisans seçeneğini—Developer, Site, ve SDK—açıklıyoruz ve ilk seferde doğru planı seçebilmeniz için pratik bir karar‑verme çerçevesi sunuyoruz.
İçindekiler
- API Belgeleri İçin Lisanslama Neden Önemlidir
- Geliştirici Lisansı – Küçük Takımlar İçin İdeal
- Site Lisansı – Belgeleri Portallar Üzerinde Ölçeklendirme
- SDK Lisansı – Görüntüleyiciyi Kendi Ürününüzde Gömme
- Karar Matrisi: Hızlı Kontrol Listesi
- Son Düşünceler ve Sonraki Adımlar
API Belgeleri İçin Lisanslama Neden Önemlidir {#api-belgeleri-icin-lisanslama-neden-onemlidir}
- Uyumluluk: Yanlış lisanslama denetim işaretleri ve beklenmeyen ücretlere yol açabilir.
- Performans: Belirli planlar, gelişmiş render pipeline'larını (OpenAPI 3.0, Swagger, RAML) ve belgelerin hızlı kalmasını sağlayan gerçek‑zamanlı iş birliğini açar.
- Ölçeklenebilirlik: Organizasyonunuz büyüdükçe, maliyet modeli belge akışının tamamen yeniden tasarlanmasını zorlamadan evrimleşmelidir.
Yanlış lisansı seçmek sadece maliyetleri artırmakla kalmaz, aynı zamanda Git senkronizasyonu, rol‑tabanlı düzenleme veya beyaz‑etiket markalaşma gibi modern DevOps iş akışları için kritik olan yetenekleri de kısıtlayabilir.
Geliştirici Lisansı {#gelistirici-lisans}
Kim Düşünmeli?
- Tek geliştiriciler veya küçük takımlar (1‑5 mühendis) iç araç veya bir kavram kanıtı oluşturuyor.
- Tek bir uygulamaya gömülü sadece bir görüntüleyici örneğine ihtiyaç duyan ekipler.
- Belgelerin tek bir kod tabanına sıkı sıkıya bağlı olduğu projeler.
Temel Özellikler
| Özellik | Projeniz İçin Ne Anlama Geliyor |
|---|---|
| Yerel API spec renderleme | OpenAPI, Swagger, RAML'ı kutudan çıkınca tam sözdizimi vurgulaması ile destekler. |
| Canlı iş birliği düzenleme | Gerçek zamanlı ortak yazar, bir proje ile sınırlı; hızlı yineleme için idealdir. |
| Sınırsız aranabilir belgeler | Projekedeki tüm markdown, HTML veya YAML dosyalarını anlık arama için indeksler. |
| Git senkronizasyonu | Tek‑tek depo senkronizasyonu—değişiklikleri gönder, güncellemeleri çek ve sürüm geçmişini kodla uyumlu tut. |
Fiyat Özeti
- $199 per developer per year (düz ücret).
- Herhangi bir kişi‑başına ya da örnek‑başına ek ücret yok.
Ne Zaman Vazgeçilmeli
Eğer aşağıdakileri öngörüyorsanız:
- Birden fazla dokümantasyon sitesi (müşteri portalları, dış ortak dokümanları), veya
- Tek bir depodan daha büyük ölçeklendirme,
Geliştirici Lisansı hızlıca bir maliyet darboğazına dönüşebilir.
Analojı: Tek bir fincan kahve podu gibi—tek bir kupa için mükemmel, ama kalabalık bir ofis için tam bir makine gerekir.
Site Lisansı {#site-lisans}
Kim Düşünmeli?
- Kurumsal ekipler birden fazla iç araç, halka açık API portalı veya yüzlerce kullanıcının eriştiği bir bilgi tabanı çalıştıranlar.
- Tutarlı marka ve tüm dokümantasyon temas noktaları için birleşik erişim kontrolü gerektiren şirketler.
Temel Özellikler
| Özellik | Fayda |
|---|---|
| Sınırsız görüntüleyici örneği | Görüntüleyiciyi istediğiniz sayıda web sitesi, intranet veya SaaS portalına dağıtabilirsiniz. |
| Merkezi lisans yönetimi | Kuruluş çapında lisans atama, iptal ve denetim için bir gösterge paneli. |
| Ekip‑geneli canlı düzenleme ve RBAC | Yazar, inceleyen, yönetici gibi ince ayarlı roller, yönetişimi güçlendirir. |
| Çok‑repo Git entegrasyonu | Monorepo’ları veya farklı depo setlerini bağlayıp her doc setini senkronize tutar. |
| Öncelikli destek ve SLA | 24‑saat yanıt süresi, minimum kesinti garantisi. |
Fiyat Özeti
- Temel: yılda 4.999 $ – 20 site’ye kadar.
- Ek site: site başına 250 $ yıllık.
Ne Zaman Değerli
- Halka açık geliştirici portalı işletiyorsanız ve üretim API’leriyle senkronize kalması gerekiyorsa.
- İç bilgi tabanınız, onlarca ekip için tek bir gerçek kaynağıdır.
- Manuel dokümantasyon güncellemelerinin maliyeti abonelik ücretinden yüksekse, Site Lisansı mantıklı bir yatırım olur.
Analojı: Tek bir araba garajından tam donanımlı bir otoparka geçmek gibi—her seferinde park yeri aramak zorunda kalmazsınız.
SDK Lisansı {#sdk-lisans}
Kim Düşünmeli?
- Ticari ürün içinde .NET görüntüleyiciyi gömen satıcılar (ör. masaüstü IDE’ler, bulut konsollar, yerel platformlar).
- Beyaz‑etiket ve tam kaynak erişimi gerektiren ekipler.
Temel Özellikler
| Özellik | Neyi Açıyor |
|---|---|
| Tam kaynak erişimi | Render pipeline’ı, UI bileşenlerini değiştirebilir veya özel kimlik doğrulamayı entegre edebilirsiniz. |
| Sınırsız dağıtım | Görüntüleyiciyi son kullanıcı kurulumlarına sayısız kez gönderirken kişi‑başına ücret yok. |
| Beyaz‑etiket | Doconut markasını kaldırıp, özel temalar ve stil kontrolü uygularsınız. |
| Özel teknik hesap yöneticisi | Entegrasyon rehberliği, performans ayarı ve yol haritası uyumu için doğrudan iletişim. |
Fiyat Özeti
- Tek seferlik ücret: 12.499 $ – kalıcı haklar.
- Opsiyonel bakım: yılda 2.999 $ (güncellemeler, güvenlik yamaları ve destek dahildir).
Ne Zaman Doğru Seçim
- Ürününüzün değer önerisi, uygulama içinde dokümantasyona dayanıyorsa (ör. bir Visual Studio eklentisi API spec’lerini satır içinde gösteriyorsa).
- Sınırsız dağıtım gerekir—görüntüleyici her bir yazılım kopyasıyla birlikte gelir.
- Marka tutarlılığı ve kaynak‑seviye özelleştirme vazgeçilmezdir.
Analojı: Kendi arabanızın motor blokunu satın almak gibi—ilk maliyet yüksek, ama motoru tamamen size ait ve istediğiniz gibi kullanabilirsiniz.
Karar Matrisi: Hızlı Kontrol Listesi {#karar-matrisi-hizli-kontrol-listesi}
| Soru | Önerilen Lisans | Neden |
|---|---|---|
| Görüntüleyici kaç farklı yerde görünecek? | Developer → 1‑2 konum Site → 3+ konum | Site Lisansı, örnek başına sınırlamayı ortadan kaldırır. |
| Görüntüleyiciyi son kullanıcılara göndermeniz gerekiyor mu? | SDK | Sınırsız dağıtım ve beyaz‑etiket. |
| Marka veya kaynak‑kodu erişimi gerekli mi? | SDK | Tam kaynak erişimi ve marka kaldırma. |
| Tercih ettiğiniz maliyet modeli nedir? | Developer → yıllık kişi‑başına Site → yıllık site‑geneli SDK → tek seferlik ön ödeme | Bütçeleme döngünüzle uyumlu. |
İpucu: Bu matrisi bir proje özeti ya da sprint planlama belgesine ekleyin; satış ekibiyle uzun tartışmalara girmeden doğru lisansı hızlıca ortaya koyar.
Son Düşünceler ve Sonraki Adımlar {#son-dusunceler-ve-sonraki-adimlar}
Doğru .NET görüntüleyici lisansını seçmek “tek beden herkese uyar” bir karar değildir. Üç temel sütuna dayanır:
- Dağıtım kapsamı – tek uygulama vs. birden fazla portal vs. ürün entegrasyonu.
- Dağıtım gereksinimleri – sadece iç kullanım mı, yoksa ticari ürünle birlikte mi.
- Bütçe döngüsü – tekrarlayan yıllık harcama mı yoksa ön ödeme yatırım mı.
Yukarıdaki özellikleri ve büyüme planınızı bu kriterlerle eşleştirerek, ileride lisans yükseltmelerinden kaçınabilir ve dokümantasyon akışınızı sorunsuz tutabilirsiniz.
Doğru lisansı kilitlemeye hazır mısınız?
- doconut.com/pricing adresini ziyaret edin ve etkileşimli seçim aracını kullanın.
- Lisans Seçici Çalışma Sayfasını indirin; karar matrisi yanıtlarınızı haritalayın.
- Daha derin bir inceleme isterseniz, 15‑dakikalık tasarım görüşmesi için çözüm mühendislerimizle bir demo randevusu ayarlayın (canlı düzenleme, API spec renderleme ve Git senkronizasyonu gösterimi).
Mutlu dokümantasyonlar, ve API’leriniz lisans kadar iyi hizmet versin!