Docora, Docus tarzı dokümantasyonu Next.js ve React'e getiriyor; AI araçları için MCP server ve llms.txt ile birlikte

Docora nedir

Docora, Next.js ve React projelerini hedefleyen yeni bir açık kaynak dokümantasyon çerçevesi. Yazarın dev.to'daki duyurusuna göre, ilhamını Nuxt ekosistemindeki dokümantasyon araç seti Docus'tan alıyor, ancak React yığını için sıfırdan yazılmış durumda. Kod GitHub'da StaticMania organizasyonu altında yayımlandı ve canlı bir demo Vercel'de deploy edildi.

Vaadi, her şeyi içinde barındıran bir dokümantasyon sitesi: içeriği koyun, production'a hazır bir site alın; normalde ek servisler gerektiren parçalar — arama, SEO altyapısı, çoklu dil desteği — çerçevenin kendisi tarafından hallediliyor.

Temel özellikler

dev.to gönderisine göre özellik seti şunları kapsıyor:

• Dosya tabanlı routing: content/ dizinine yerleştirilen her dosya otomatik olarak bir sayfa rotasına dönüşüyor.
• MDC sözdizimi: yazarlar Markdown yazıyor ve import eklemeden daha zengin bileşenler — callout'lar, kartlar, sekmeler ve adım listeleri — elde ediyor.
• Yerleşik arama: derleme zamanında oluşturulan bir komut paleti; süreçte üçüncü taraf bir barındırılan arama servisi yok.
• SEO varsayılanları: sitemap, robots kuralları, canonical linkler ve otomatik oluşturulan Open Graph görselleri.
• Çoklu dil desteği: her yerel ayar için bir klasör, arama motorları için hreflang etiketleriyle birlikte.
• AI'ya yönelik endpoint'ler: deploy edilen her site, /mcp adresinde bir MCP server ve otomatik oluşturulmuş bir llms.txt dosyası sunuyor; böylece Cursor ve Claude gibi araçlar sayfaları kazımak yerine dokümantasyonu doğrudan okuyabiliyor.

Ayrıca AI SDK ile oluşturulmuş ve Vercel'in AI Gateway üzerinden yönlendirilen isteğe bağlı bir Ask AI sohbet widget'ı da var.

Başlangıç

Kurulum tek bir komut — npx create-docora my-docs — ve ardından yeni projenin içinde npm run dev. Bunun ötesinde yazar, geliştirici deneyimi, eksik özellikler ve hatalar konusunda topluluktan geri bildirim açıkça istiyor; bu da projenin henüz erken aşamada olduğunu ve kullanıcıları tarafından şekillendirildiğini gösteriyor.

Ask AI'daki sorun

Duyuruda açıklanan tek sorun noktası altyapı. Docora tamamen Vercel'in yığını üzerine inşa edilmiş — Next.js, Vercel'de deploy ve sohbet özelliği için AI Gateway — ve ücretsiz AI Gateway katmanı şu anda kullanımı sınırlıyor. Sonuç olarak yazar, canlı demoyu ziyaret edenlerin çoğunun Ask AI'yı tam olarak deneyemediğini bildiriyor. Gönderi, okuyuculardan Vercel'in Open Source Programı veya benzeri bir destek konusunda ipuçları istiyor; böylece sohbet özelliği, çoğu ziyaretçi için kısılacağına, Next.js topluluğunun deneyip öğrenmesi için açık kalabilir.

Neden önemli

Dokümantasyon araçları React dünyasında hep sorunlu bir boşluk oldu. En güçlü özel seçenekler tarihsel olarak başka yerlerdeydi — Nuxt ekosisteminde Docus, Vue tarafında VitePress, kendi React tabanlı araç zincirinde Docusaurus — buna karşılık Next.js projeleri çoğu zaman dokümantasyon kurulumunu ham MDX ve bir yığın eklentiden derlemek zorunda kalıyordu. Docora, bu boşluğu aynı konfigürasyon yerine sözleşme ergonomisiyle kapatma girişimi; quickstart'ı da denemenin engelinin sıfıra yakın olduğunu gösteriyor.

Daha yenilikçi kısım ise AI-native bakış açısı. Varsayılan olarak MCP server ve llms.txt sunmak, AI kodlama asistanlarını tarayıcılar ve arama tarayıcılarının yanı sıra dokümantasyonun birinci sınıf tüketicileri olarak kabul ediyor. Bu desen yayılırsa, "doküman siteniz makine tarafından okunabilir mi" sorusu "sitemap'iniz var mı" kadar standart bir soru hâline gelir.

Proje genç ve uzun vadeli sürdürülebilirliği topluluğun benimsemesine, Ask AI açısından ise özellikle sürdürülebilir bir barındırma düzeni bulunmasına bağlı. Ama dokümantasyon araçlarının nereye gittiğinin bir sinyali olarak — her şeyin derleme zamanında yapılması, içeriğin insanlar kadar agent'lar için de yazılması — izlemeye değer.