Happy Valley

Docusaurus vs Fern

Docusaurus ve Fern, ikisi de geliştiriciler için tasarlanmış API ve geliştirici dokümantasyonu araçları. İkisinin de ücretsiz planı var.

Docusaurus

React ile statik dokümantasyon siteleri

Fern

API tanımından SDK ve dokümantasyon üretimi

FiyatlandırmaAçık kaynakFreemium
Başlangıç fiyatıAçıklanmamışAçıklanmamış
Ücretsiz planVarVar
Ücretsiz deneme——
Kimler içinGeliştiricilerGeliştiriciler
Platformlarwebweb
ÜlkeUS · 2017US · 2022
Puan——

Docusaurus kimler için uygun

Ücretsiz, özelleştirilebilir ve Git ile yönetilen dokümantasyon isteyen geliştirici ekipleri.

  • Ücretsiz ve MIT lisanslı açık kaynak
  • Tasarım ve davranış üzerinde tam kontrol
  • Açık kaynak projeler için fiili standart

Şu durumda başka araca bak: Görsel editör isteyen teknik olmayan yazar ekipleri (GitBook, Mintlify).

Fern kimler için uygun

Birden çok dilde SDK ve senkron dokümantasyon yayınlaması gereken API öncelikli şirketler.

  • Elle SDK yazma ve bakım yükünü büyük ölçüde kaldırıyor
  • Üretilen kod her dilin alışkanlıklarına uygun
  • SDK ve dokümantasyon tek kaynaktan besleniyor

Şu durumda başka araca bak: Dış geliştiricisi olmayan küçük iç API'ler veya yalnızca dokümantasyon arayan ekipler (Mintlify, Redocly).

Docusaurus ve Fern fiyatları

Docusaurus

  • Open source$0MIT license, self-hosted static site generator

Fern

  • Free$010 team members, 1,000 pages, custom domain
  • EnterpriseCustomSSO, SCIM, RBAC, self-hosting, SLA

Docusaurus · Öne çıkan özellikler

  • Markdown ve React bileşeni gömülebilen MDX ile yazım
  • Ürün sürümlerine göre doküman sürümleme
  • Çok dilli siteler için yerleşik i18n desteği
  • Doküman yanında blog ve özel sayfalar
  • Algolia DocSearch arama entegrasyonu
  • Eklenti sistemi ve swizzling ile tema özelleştirme

Eksiler

  • Kurulum ve bakım için geliştirici zamanı gerekir
  • Barındırılan analitik veya yapay zeka yanıtları yok
  • Öne çıkmak için tasarıma emek vermek gerekir

Fern · Öne çıkan özellikler

  • OpenAPI veya Fern tanımından çok dilli SDK üretimi
  • TypeScript, Python, Java, Go, C# ve Ruby desteği
  • API referansı şartnameyle senkron dokümantasyon sitesi
  • CI üzerinden npm, PyPI ve Maven'a otomatik yayın
  • Etkileşimli API playground ve kod örnekleri
  • Sürümleme, özel alan adı ve yapay zeka araması

Eksiler

  • Ücretli plan fiyatları yayınlanmıyor, satış görüşmesi gerekiyor
  • Çıktı kalitesi OpenAPI şartnamesinin kalitesine bağlı
  • Üretilen koda dayanmak sağlayıcı bağımlılığı yaratıyor

Docusaurus vs Fern: Sık sorulan sorular

Docusaurus ve Fern ücretsiz plan sunuyor mu?

Evet, Docusaurus ve Fern ücretsiz plan sunuyor; ücretli planlar daha fazla kullanım ve özellik ekliyor.

Henüz karar veremedin mi?