Moonborn dokümantasyonuna hoş geldin
Geliştirici, yazar, oyun yapımcısı, marka ekibi, ürün ekibi, araştırmacı ve yöneticiler için tek dokümantasyon merkezi. Konuya veya role göre yön değiştir. EN/TR/DE yerelleştirilmiştir.
Bu site Moonborn'un geliştiriciye dönük (developer-facing) her şeyinin yeni evidir. Üç şey bilmek yeter.
Bu yazıda ne anlatılıyor
- Tek merkez, iki yön — konu (topic) ile rol (role) taksonomisi
- API referansı otomatik üretilir — OpenAPI belirtimi → uç nokta sayfaları
- 3 dil-bölge (locale) — EN/TR/DE
- Eski URL'ler ne oldu (yönlendirme — redirect — var)
- Yol haritasının özeti
Hızlı başlamak istiyorsan: Hızlı başlangıç.
1. Tek merkez, iki yön
Üst çubuktaki anahtar By topic (konu) ile By role (rol) arasında geçiş yapar:
| Yön | Kategoriler |
|---|---|
| Konuya göre | Get started · Tutorials · Use cases · Concepts · Guides · API reference · SDKs · Integrations · Reference · Blog · Pricing |
| Role göre | Developer · Writer · Game maker · Brand team · Product team · Researcher & admin |
Aynı içerik, iki taksonomi. Tercihin çerez (cookie) + URL parametresi ile sayfalar arasında kalıcı kalır.
2. API referansı — otomatik üretilir
/api-reference/ altındaki her uç nokta sayfası kanonik OpenAPI belirtiminden (/openapi.json) otomatik üretilir. API hareket ettikçe 153 işlem (operation) hareket eder; dokümanlar senkron kalır.
İstersen kendi istemcini de bu belirtimden kur:
curl https://api.moonborn.co/openapi.json > openapi-snapshot.json
# Sonra: openapi-generator / orval / oazapfts ...CI, apps/api/openapi.json ↔ apps/docs/public/openapi.json dosyalarını bayt-aynı (byte-identical) tutar.
3. Üç dil-bölge
| Dil-bölge | URL öneki |
|---|---|
| İngilizce (kanonik) | / |
| Türkçe | /tr/ |
| Almanca | /de/ |
Dil-bölge anahtarı sağ üsttedir; tercihin URL önekine yansır. Domain (alan) terimleri (Soul, Self, Mask, Surface, voice fingerprint, drift, lineage, distinctiveness, ensemble) İngilizce kalır — TR/DE çevirileri jargon-saftır.
Bu sürümde ne değişti
Eski yüzeyler → tek paylaşılan içerik paketi:
moonborn.co/docs → docs.moonborn.co
moonborn.co/docs/api/... → docs.moonborn.co/api-reference/...
app.moonborn.co/docs (ürün içi) → aynı içerik, çalışma alanı kabuğu (shell)Yer imleri (bookmarks) çalışmaya devam eder:
moonborn.co/docs/quickstart→ 308 yönlendirme →docs.moonborn.co/quickstartdocs.moonborn.co/api-reference/personas/create-persona→ değişmedi
Yol haritası özeti
Kısa ve somut:
| Sprint | Çıktı |
|---|---|
| Yakın | Hedef kitle başına daha fazla eğitim |
| v1.1 | Git eşitlemesi HTTP yüzeyi (şu an önizleme — preview) |
| v1.1 | Kalite hattı için daha derin rehberler |
| Sürekli | TR + DE çeviri geçişleri |
Değişiklik kaydı (changelog) her sürümü listeler: Referans / Changelog. Bu blog daha büyük yenilikleri kapsar — sürüm yayını, mimari kayma, ara sıra derin dalış.
Hoş geldin.