Bump.sh vs ReadMe

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ı.

ReadMe, 2014'te San Francisco'da kurulan ve birçok API öncelikli şirketin dokümantasyonunu yayınladığı bir geliştirici merkezi (developer hub) platformu. Rehberleri, etkileşimli API referansını, değişiklik günlüklerini, tarifleri ve tartışma forumunu; ürün ve geliştirici ilişkileri ekiplerinin ayrı bir dokümantasyon mühendisliği ekibi olmadan düzenleyebildiği tek bir barındırılan sitede toplar.

API referansı OpenAPI veya Swagger tanımlarından üretilir; gerçek çağrılar yapan bir try-it konsolu ve birçok dilde kod örneği içerir. Giriş yapmış geliştiriciler kendi API anahtarlarını önceden doldurulmuş görür; bu da ilk başarılı çağrıya kadar geçen süreyi kısaltır. ReadMe'nin ayırt edici özelliği API metrikleridir: hafif bir SDK veya entegrasyonla hangi müşterinin hangi endpoint'i ne sıklıkla ve hangi hatalarla çağırdığını gösterir, bu logları dokümantasyona ve desteğe bağlar. AI asistanı Owlbot, geliştirici sorularını dokümantasyondan yanıtlar. Planlar ücretsiz Starter katmanından, yıllık faturayla ayda 250 dolarlık ve sınırsız sürüm ile daha fazla yönetici ekleyen Pro'ya uzanır; Enterprise çok projeli yönetişim ve SSO ekler.

ReadMe, API'si temel ürünü olan ve dokümantasyon, onboarding ile kullanım analitiğini tek yerde isteyen şirketlere uyar. Pro'dan Enterprise'a geçişte maliyet hızla artar; dokümantasyonu git'te kod olarak yönetmek isteyen ekipler modern tasarım ve güçlü git akışları sunan Mintlify'ı tercih edebilir. Redocly ve Stoplight API tasarımı ve yönetişiminde güçlüdür; Docusaurus ve Scalar küçük projeler için ücretsiz seçeneklerdir.