Bump.sh vs Docusaurus

Bump.sh, CEO Sébastien Charrier liderliğindeki küçük ve tamamen uzaktan çalışan bir Fransız ekibin barındırılan API dokümantasyon platformu. OpenAPI ve AsyncAPI tanımlarını repodan alıp hızlı referans dokümanlara çeviriyor, her yeni sürümü öncekiyle karşılaştırarak breaking change'leri işaretliyor ve changelog'u otomatik üretiyor. API sözleşmesini tek doğru kaynak kabul eden ekipler için docs-as-code yaklaşımı sunuyor.

Her commit veya pull request, CLI ya da GitHub Action ile dokümanı yayınlayabiliyor veya önizleme oluşturabiliyor; API hub'ları birden fazla API'yi özel alan adlı tek portalda topluyor. Pro planı branch yönetimi, API Explorer, sürüm geri alma ve otomatik changelog ekliyor. Ücretsiz plan yok: Basic 10 doküman için aylık 50 dolar, Pro 30 doküman için aylık 120 dolar ve 14 gün deneme içeriyor; Custom ise SSO, embed modu ve yüzde 99,99 SLA sunuyor. Açık kaynak projeler ücretsiz Pro erişimi isteyebiliyor.

Bump.sh, çok sayıda iç veya herkese açık API yayınlayan platform ekiplerine, özellikle olay tabanlı mimarilere uygun; AsyncAPI desteği birinci sınıf. Uzun rehberler ve pazarlama odaklı portallar için zayıf. Anlatı tipi dokümanda ReadMe ve Mintlify daha güçlü, Redocly benzer OpenAPI araçlarını daha fazla linting ve self-host seçeneğiyle sunuyor, Stoplight design-first düzenlemeye odaklanıyor.

En önemli yenilik, yakın zamanda sunulan yönetilen MCP platformu: Bump.sh artık API tanımlarından ve Arazzo iş akışı dosyalarından MCP sunucuları üretip kimlik doğrulama ve izlemeyle barındırıyor; böylece AI ajanları API'nizi güvenle çağırabiliyor. Basic planda yalnızca beş MCP aracı olduğunu unutmayın. Fiyatlar dolar bazlı.

Docusaurus, Meta'nın açık kaynak ekibi tarafından geliştirilen ve MIT lisansıyla yayımlanan, dokümantasyona odaklı bir statik site üreticisi. Sayfaları Markdown veya belgelerin içine React bileşeni gömmeye izin veren MDX ile yazarsınız; Docusaurus da gezinme menüsü, kenar çubukları, blog ve aramaya sahip hızlı bir statik site üretir. Bu siteyi GitHub Pages, Netlify, Vercel veya herhangi bir statik barındırma servisinde yayınlayabilirsiniz.

Öne çıkan özellikler arasında her ürün sürümünün kendi dokümanlarını tuttuğu sürümleme, çeviri siteleri için yerleşik çoklu dil (i18n) desteği, eklenti sistemi, tema bileşenlerini değiştirmeye yarayan swizzling ve uygun açık kaynak projelere ücretsiz sunulan Algolia DocSearch entegrasyonu var. 3. sürümle MDX 3 ve React 18'e geçildi. Ücretli bir katmanı yok; asıl maliyet siteyi kurmak, tasarlamak, barındırmak ve bakımını yapmak için harcanan geliştirici zamanı. React Native, Jest ve Redux gibi projelerin dokümantasyonu Docusaurus ile yayınlanır.

Docusaurus, Git içinde docs-as-code yaklaşımı ve tasarım üzerinde tam kontrol isteyen mühendislik ekiplerine ve açık kaynak projelere uyar. i18n desteği sayesinde Türkçe ve İngilizce dokümanı aynı projede yönetmek kolay. Teknik olmayan yazarlar Markdown dosyası düzenleyip pull request açmak zorunda kaldığı için zorlanır; barındırılan analitik, yapay zeka yanıtları ve görsel editör de yok. GitBook ve Mintlify görsel editörlü ve yapay zekalı barındırılan alternatifler, Material temalı MkDocs Python dünyasındaki karşılığı, Astro'nun Starlight'ı ve Nextra ise daha yeni statik seçenekler.