@intlayer/docs 9.0.0-canary.2 → 9.0.0-canary.20

package/docs/tr/releases/v7.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Intlayer v7'ye hoş geldiniz! Bu büyük sürüm, performans, tür güvenliği ve geliştirici deneyiminde önemli iyileştirmeler sunuyor. Aşağıda, geçiş notları ve pratik örneklerle birlikte öne çıkanlar yer almaktadır.
 
+## İçindekiler
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Öne Çıkanlar
 
 - Daha hızlı derlemeler için önbellekleme stratejisi
@@ -260,6 +264,126 @@ Bu, uygulamanız için daha hızlı indirme süreleri ve geliştirilmiş çalı
 
 ---
 
+## Otomatik Kod Biçimlendirmesi: formatCommand configuration
+
+v7, editör yapılandırmasında `formatCommand` seçeneğini tanıtarak, Intlayer tarafından yazıldığında içerik dosyalarını otomatik olarak biçimlendirmenizi sağlar. Bu, içerik bildirimi dosyalarınız arasında tutarlı kod stili ve biçimlendirmesini sağlar.
+
+Ayarlanmadığında, Intlayer biçim komutunu otomatik olarak algılamaya çalışacaktır. Şu komutları çözmeyi deneyerek: prettier, biome, eslint.
+
+### Konfigürasyon
+
+`formatCommand` seçeneği, `{{file}}` ifadesinin gerçek dosya yolu ile değiştirildiği bir string şablonunu kabul eder:
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    formatCommand: 'bun x biome format "{{file}}" --write --log-level none',
+  },
+};
+```
+
+### Desteklenen formatters
+
+Dosya yollarını argüman olarak kabul eden herhangi bir kod formatteri kullanabilirsiniz:
+
+**Biome kullanarak:**
+
+```typescript
+formatCommand: 'bun x biome format "{{file}}" --write --log-level none';
+```
+
+**Prettier kullanarak:**
+
+```typescript
+formatCommand: 'npx prettier --write "{{file}}" --log-level silent';
+```
+
+**ESLint kullanarak:**
+
+```typescript
+formatCommand: 'npx eslint --fix "{{file}}" --quiet';
+```
+
+**Bun'ın yerleşik formatteri kullanarak:**
+
+```typescript
+formatCommand: 'bun format "{{file}}"';
+```
+
+### Faydalar
+
+- **Tutarlı biçimlendirme**: Tüm içerik dosyaları, projenizin stil yönergelerine göre otomatik olarak biçimlendirilir
+- **Geliştirici deneyimi**: Intlayer dosyaları yazdıktan sonra dosyaları manuel olarak biçimlendirmeye gerek yoktur
+- **Takım tutarlılığı**: Tüm takım üyelerinin içerik dosyalarına aynı biçimlendirmenin uygulanmasını sağlar
+- **CI/CD entegrasyonu**: İçerik dosyaları, otomatik iş akışlarında tutarlı biçimlendirmeyi korur
+
+### Nasıl çalışır
+
+Intlayer bir içerik bildirimi dosyasını (`.content.ts`, `.content.js`, vb.) yazdığında veya güncellediğinde, dosya üzerinde belirtilen format komutunu otomatik olarak çalıştırır. `{{file}}` yer tutucu gerçek dosya yolu ile değiştirilir ve komut projenin temel dizininde yürütülür.
+
+---
+
+## Sözlük Yapılandırması: Daha İyi Organizasyon ve Yapı
+
+v7, sözlük ile ilgili ayarlar için daha iyi bir organizasyon ve geliştirilmiş içerik yönetimi sağlayan yeni bir adanmış `dictionary` yapılandırma bölümü sunar.
+
+### Yeni dictionary yapılandırması
+
+`fill` özelliği, `content` bölümünden yeni `dictionary` bölümüne taşınmış, sorumlulukların daha net bir şekilde ayrılmasını sağlamıştır:
+
+**v6 yapılandırması:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    autoFill: "./{{fileName}}.content.json",
+    contentDir: ["src"],
+  },
+};
+```
+
+**v7 yapılandırması:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    contentDir: ["src"],
+  },
+  dictionary: {
+    fill: "./{{fileName}}.content.json",
+  },
+};
+```
+
+### Yeni yapının faydaları
+
+- **Daha net organizasyon**: Sözlüğe özgü ayarlar artık bir arada gruplandırılıyor
+- **Daha iyi sorunların ayrılması**: İçerik keşfi vs. sözlük işlemleri açıkça ayrılıyor
+- **Geliştirilmiş bakım kolaylığı**: Sözlükle ilgili konfigürasyonları anlamak ve değiştirmek daha kolay
+- **Gelecekteki genişletilebilirlik**: Sözlük bölümü ek sözlüğe özgü ayarları barındırabiliyor
+- **Kapsamlı sözlük yönetimi**: Yeni sözlükler oluşturmak ve yönetmek için `title`, `live`, `priority`, `tags`, `version` ve `description` gibi özellikleri içeriyor
+
+### Yapılandırma kullanımı
+
+Sözlük yapılandırması iki ana amaca hizmet eder:
+
+1. **Varsayılan Değerler**: İçerik bildirim dosyaları oluştururken varsayılan değerleri tanımlama
+2. **Fallback Davranışı**: Belirli alanlar tanımlanmadığında fallback değerleri sağlama, sözlük işlem davranışını global olarak tanımlamanıza izin verme
+
+Sözlük bölümü, sözlük yönetimi için kapsamlı özellikler içerir:
+
+- **`fill`**: İçerik oluşturma için otomatik doldurma davranışı
+- **`title`**: Yeni sözlükler için varsayılan başlık
+- **`live`**: Gerçek zamanlı güncellemeler için live senkronizasyon yapılandırması
+- **`priority`**: Sözlük çözümlemesi için öncelik ayarları
+- **`tags`**: İçerik organizasyonu için varsayılan etiketler
+- **`version`**: Sözlük güncellemeleri için sürüm yönetimi
+- **`description`**: Yeni içerik için varsayılan açıklama
+
+İçerik bildirim dosyaları ve yapılandırma değerlerinin nasıl uygulandığı hakkında daha fazla bilgi için bkz. [İçerik Dosyası Belgeleri](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/content_file.md).
+
+---
+
 ## Fill komutu: Daha iyi içerik yönetimi için güncellenmiş davranış
 
 v7, `fill` komutu için daha öngörülebilir ve esnek içerik yönetimi sağlayan geliştirilmiş bir davranış sunar:
@@ -407,6 +531,10 @@ Sistem otomatik olarak:
 - **`middleware.prefixDefault`**: `routing.mode` ile değiştirildi
 - **`middleware.noPrefix`**: `routing.mode` ile değiştirildi
 
+### Yeni konfigürasyonlar
+
+- **`editor.formatCommand`**: İçerik dosyalarının otomatik kod formatlaması için yeni seçenek
+
 ### Geçiş eşlemesi
 
 #### Konfigürasyon eşlemesi

package/docs/tr/releases/v9.md

@@ -1,15 +1,17 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-14
+updatedAt: 2026-07-08
 title: Yeni Intlayer v9 - Yenilikler Neler?
-description: Intlayer v9'daki yenilikleri keşfedin. Popüler i18n kütüphaneleri için doğrudan uyumlu paketler ve Koleksiyonlar, Varyantlar ve Dinamik Kayıtlar desteği sunuluyor.
+description: Intlayer v9'daki yenilikleri keşfedin. Popüler i18n kütüphaneleri için doğrudan uyumlu paketler ve Koleksiyonlar ve Varyantlar desteği sunuluyor.
 keywords:
   - Intlayer
   - Compatibility
   - Migration
   - Collections
   - Variants
-  - Dynamic Records
+  - CMS SDK
+  - Self-Hosting
+  - Docker
   - i18next
   - next-intl
   - vue-i18n
@@ -22,7 +24,7 @@ author: aymericzip
 
 # Yeni Intlayer v9 - Yenilikler Neler?
 
-Intlayer v9'a hoş geldiniz! Bu ana sürüm, büyük i18n kütüphaneleri (`react-i18next`, `next-intl`, `vue-i18n` vb.) için sunulan **Compat Adapter Paketleri** ile Intlayer'a geçiş sürecini basitleştirmede dev bir adımı temsil ediyor ve zengin içerik yapıları için destek ekliyor: **Koleksiyonlar (Collections)**, **Varyantlar (Variants)** ve **Dinamik Kayıtlar (Dynamic Records)**.
+Intlayer v9'a hoş geldiniz! Bu ana sürüm, büyük i18n kütüphaneleri (`react-i18next`, `next-intl`, `vue-i18n` vb.) için sunulan **Compat Adapter Paketleri** ile Intlayer'a geçiş sürecini basitleştirmede dev bir adımı temsil ediyor ve zengin içerik yapıları için destek ekliyor: **Koleksiyonlar (Collections)** ve **Varyantlar (Variants)**.
 
 ## İçindekiler
 
@@ -41,8 +43,10 @@ Popüler i18n kütüphanelerinden Intlayer'a geçiş yapmak artık her zamankind
 - `@intlayer/i18next`
 - `@intlayer/react-i18next`
 - `@intlayer/next-intl`
+- `@intlayer/react-intl`
 - `@intlayer/next-i18next`
 - `@intlayer/vue-i18n`
+- `@intlayer/lingui`
 
 Örneğin, sadece şunu değiştirin:
 
@@ -100,7 +104,7 @@ Tüm compat adapter'lar artık çeviri çözümlemesini tek ve son derece optimi
 
 ---
 
-## Özellik Detayları: Koleksiyonlar, Varyantlar ve Dinamik Kayıtlar
+## Özellik Detayları: Koleksiyonlar ve Varyantlar
 
 Intlayer v9, statik anahtar-değer nesnelerinin ötesine geçerek sözlüklerin uçtan uca tam tiplendirilmiş dinamik düzen yapıları tanımlamasına olanak tanır.
 
@@ -108,42 +112,48 @@ Intlayer v9, statik anahtar-değer nesnelerinin ötesine geçerek sözlüklerin
 
 CMS tarafından yönetilen sıralı öğelerin bir listesini tanımlayın (örneğin SSS'ler, ürünler veya blog listeleri):
 
-```ts fileName="faq.content.ts"
+```ts fileName="faq.1.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "faq",
-  content: [
-    {
-      question: t({
-        tr: "Intlayer nedir?",
-        en: "What is Intlayer?",
-        fr: "Qu'est-ce qu'Intlayer ?",
-      }),
-      answer: t({
-        tr: "Bir i18n araç kiti.",
-        en: "An i18n toolkit.",
-        fr: "Une boîte à outils i18n.",
-      }),
-    },
-  ],
+  item: 1,
+  content: {
+    question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
+    answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
+  },
+} satisfies Dictionary;
+```
+
+```ts fileName="faq.2.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 2,
+  content: {
+    question: t({ en: "Is it free?", fr: "Est-ce gratuit ?" }),
+    answer: t({ en: "Yes, open-source.", fr: "Oui, open-source." }),
+  },
 } satisfies Dictionary;
 ```
 
 #### Kullanım:
 
 ```ts
-// Tüm öğeleri getir
+// Fetch all items as an array
 const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
 
-// Dizine göre tek bir öğe getir
-const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+// Fetch a single item by index
+const faq = useIntlayer("faq", { item: 2 }); // -> { question: string, answer: string }
 ```
 
 ### 2. Varyantlar (Variants)
 
 A/B testleri, mevsimsel başlıklar, özellik bayrakları (feature flags) veya özel açılış sayfaları sunun:
 
+#### Dize varyantları (örneğin, A/B testleri)
+
 ```ts fileName="hero.content.ts"
 import { t, type Dictionary } from "intlayer";
 
@@ -167,16 +177,14 @@ export default {
 const banner = useIntlayer("hero-banner", { variant: "black_friday" });
 ```
 
-### 3. Dinamik Kayıtlar (Dynamic Records)
-
-Girdileri çalışma zamanında sorgu kimlikleri (query IDs) aracılığıyla dinamik olarak yüklenen sözlükler tanımlayın:
+#### Nesne varyantları (örneğin, Dinamik Kayıtlar)
 
 ```ts fileName="product.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "product-copy",
-  meta: {
+  variant: {
     id: "prod_123",
     category: "books",
   },
@@ -191,28 +199,171 @@ export default {
 ```ts
 // Yalnızca talep edilen öğeyi dinamik olarak getirir (Suspense gerektirir)
 const product = useIntlayer("product-copy", {
-  id: "prod_123",
-  category: "books",
+  variant: { id: "prod_123", category: "books" },
 });
 ```
 
 ---
 
-## Dinamik Yükleme ve Bundle Boyutu Optimizasyonları
+## `@intlayer/analytics`: içerik gösterim takibi ve A/B testi
+
+Yeni bir isteğe bağlı paket olan [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md), ziyaretçilerinize gerçekte hangi içeriğin gösterildiğini bildirir — ve içerik üzerinde A/B testi yapmanıza ve varyant başına dönüşümleri ölçmenize olanak tanıyarak **Collections & Variants** döngüsünü tamamlar.
+
+- **Provider düzeyinde takip**: `IntlayerProvider` (React / Next.js / React Native) yükleme, rota değişikliği ve dil değişikliğinde otomatik olarak `page_view` olayları kaydeder.
+- **Node düzeyinde takip**: her `useIntlayer` çözümlemesi bir `content_exposure` olayı bildirir — hangi sözlük anahtarı, anahtar yolu, dil ve (varsa) hangi A/B **varyantı** gösterildiği. Bir flush penceresi içinde aynı düğümün tekrarlanan gösterimleri tek bir olayda birleştirilir.
+- **Deterministik A/B ataması**: `getVariant(experimentKey, variants)`, **sunucuya gidiş-dönüş olmadan** her oturuma bir varyant atar, bu nedenle ilk render öncesinde titreme olmaz.
+- **`useConversion()`**: bir hedefi (kayıt, tıklama, satın alma…) oturumun maruz kaldığı varyanta atfeder.
+- **Kurulu değilse sıfır maliyet**: `@intlayer/editor` ile aynı tree-shakeable desen — `try/catch` içine sarılmış dinamik `import()`, artı bunu etkinleştirmeyen uygulamalar için tüm entegrasyonu ölü kod olarak kaldıran bir derleme zamanı ortam değişkeni (`INTLAYER_ANALYTICS_ENABLED`).
+- **Yeni bir yapılandırma şeması yok**: mevcut `editor.backendURL` (gönderim uç noktası / kendi sunucunuzda barındırma) ve `editor.clientId` (proje anahtarı, aynı zamanda etkinleştirme anahtarı) yeniden kullanılır.
+- **Gizliliğe saygılı**: anonim oturum hashleme (SHA-256, ham kimlikler saklanmaz), IP saklanmaz, yalnızca kaba ülke düzeyinde konum, istekler yaklaşık her 20 saniyede bir toplu olarak gönderilir.
+- **Kontrol paneli**: bir proje seçildikten sonra kenar çubuğunda görünen yeni bir **Analytics** sayfası; aktif kullanıcıları, bugünkü kullanıcıları, son 7/30/90 gündeki kullanıcıları, bir ziyaretçi gelişim grafiğini ve Yerel Ayar/Konum dağılımlarını gösterir.
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      Get started
+    </button>
+  );
+};
+```
 
-Bundle boyutlarını son derece küçük tutmak için Intlayer v9 dinamik tembel yüklemeyi (dynamic lazy loading) destekler.
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+Bugün React, Next.js ve React Native (`react-intlayer` üzerinden) için kullanılabilir; diğer framework bağlamaları (Vue, Svelte, Angular, …) `@intlayer/editor` ile aynı yayılma desenini izleyerek planlanmaktadır. Tam kılavuz için [Analytics belgelerine](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) bakın.
+
+---
 
-Yapılandırmanızda `importMode` değerini `'dynamic'` veya `'fetch'` olarak ayarlayın:
+## Vite Plugin: Bundled Compiler & Proxy
+
+`intlayer()` Vite eklentisi artık **compiler** ve **locale-routing proxy**'i doğrudan içeriyor, bu nedenle çoğu proje `vite.config.ts` içinde yalnızca tek bir eklentiye ihtiyaç duyuyor:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **Compiler**: `compiler.enabled` `true` olarak ayarlandığında ve `compiler.output` yolu yapılandırıldığında otomatik olarak etkinleştirilir. Artık `intlayerCompiler()`'ı ayrı olarak kaydetmeniz gerekmez.
+- **Proxy**: Yeni `routing.enableProxy` seçeneğine göre otomatik olarak etkinleştirilir (varsayılan olarak `true`). Geliştirme, önizleme ve üretim SSR'de locale algılama / yönlendirme / yeniden yazma middleware'ini bağlar. Artık `intlayerProxy()`'ı ayrı olarak kaydetmeniz gerekmez.
+
+### `routing.enableProxy` seçeneği
+
+Yeni `routing.enableProxy` seçeneği, locale-routing proxy'sinin bağlanıp bağlanmadığını kontrol eder. Varsayılan değer `true`'dur. Locale yönlendirmesini kendiniz işlemek istediğinizde devre dışı bırakın:
 
 ```ts fileName="intlayer.config.ts"
-export default {
-  dictionary: {
-    importMode: "dynamic", // "static" | "dynamic" | "fetch"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // Varsayılan: true
   },
 };
+
+export default config;
+```
+
+Bağımsız `intlayerCompiler()` ve `intlayerProxy()` eklentileri gelişmiş kurulumlar için dışa aktarılmaya devam eder. Bunları `intlayer()` ile birlikte kaydetmek güvenlidir — her eklenti kendisini çoğaltır ve yalnızca bir kez çalışır.
+
+---
+
+## Derleyici varsayılan olarak devre dışı
+
+Intlayer v9'dan itibaren, **derleyici varsayılan olarak devre dışıdır** (`compiler.enabled` artık varsayılan olarak `false`'tur). `.content.ts` dosyalarınızın derleme zamanı çıkarımını etkinleştirmek için yapılandırmanızda `compiler.enabled: true` olarak ayarlayın:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    enabled: true, // Varsayılan: false — v9'dan itibaren derleyiciyi etkinleştirmek için gereklidir
+    output: ({ fileName }) => `./${fileName}.content.ts`,
+  },
+};
+
+export default config;
+```
+
+Derleyici devre dışı bırakıldığında, Intlayer derleme zamanı çıkarım adımını atlar ve önceden bildirdiğiniz sözlüklere dayanır. Yalnızca bundler eklentisinin (`@intlayer/swc`, `@intlayer/babel` veya `intlayer()` Vite eklentisi) içeriği otomatik olarak çıkarmasını istediğinizde etkinleştirin.
+
+---
+
+## React Native: tek paket içe aktarmaları
+
+Bir React Native veya Expo uygulamasında, artık `react-intlayer` ve `react-native-intlayer` arasında gidip gelmenize gerek yok. `react-native-intlayer` paketi artık **tüm `react-intlayer` API'sini yeniden dışa aktarıyor** (hook'lar, yardımcı programlar ve `/format`, `/html` ve `/markdown` alt yolları) ve `IntlayerProvider`'ı React Native polyfill'lerini otomatik olarak uyguluyor.
+
+Her şeyi tek `react-native-intlayer` paketinden içe aktarın:
+
+```tsx
+import {
+  IntlayerProvider,
+  useIntlayer,
+  useLocale,
+} from "react-native-intlayer";
+```
+
+```bash
+npm install intlayer react-native-intlayer
+```
+
+> `react-intlayer`'dan içe aktarmak çalışmaya devam eder, ancak `react-native-intlayer` artık React Native için önerilen tek giriş noktasıdır — sağlayıcısı, web odaklı `react-intlayer` sağlayıcısının sahip olmadığı polyfill'leri içerir.
+
+---
+
+## CMS SDK: Intlayer'ı başsız içerik veritabanı olarak kullanın
+
+Intlayer v9, CMS ile programatik olarak etkileşim kurmak için `@intlayer/api` içinde temiz ve kendi kendine kimlik doğrulayan bir SDK sunar — projeleri getirin, sözlükleri getirin ve bunları kendi sunucunuzdan, betiklerinizden veya CI'nizden gönderin ya da güncelleyin. Kimlik doğrulama (OAuth2 `client_credentials`) sizin için yönetilir ve yenilenir.
+
+SDK **iki ayrı içe aktarmaya** bölünmüştür; böylece paketiniz yalnızca gerçekten kullandığınız alanları içerir:
+
+1. `createIntlayerCMS` — kimlik bilgilerini ve yönetilen jetonu tutan hafif bir **kimlik doğrulayıcı** (hiçbir alan istemcisi pakete dahil edilmez).
+2. `dictionaryEndpoint`, `projectEndpoint`, … — her biri kendi alt yolundan içe aktarılan, alan başına **endpoint bağlayıcıları**.
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// Yapılandırma isteğe bağlıdır: kimlik bilgileri INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET değerlerine geri döner (`@intlayer/config/built` tarafından çözülür).
+const cms = createIntlayerCMS();
+
+// Okuma
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// Yazma — CMS'i bir veritabanı gibi kullanın
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> Güvenlik: CMS kimlik bilgileri içeriğinize yazma erişimi verir. Kimlik doğrulayıcıyı her zaman yalnızca **sunucu tarafında** oluşturun — `clientId` / `clientSecret` değerlerini asla tarayıcıya göndermeyin.
+
+---
+
+## Kendi Sunucunuzda Barındırma
+
+Intlayer v9, tek bir komutla kendi Intlayer örneğinizi çalıştırmak için birinci sınıf destek sunuyor — Intlayer Cloud hesabı gerekmez.
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
-Derleme zamanında, `@intlayer/swc` ve `@intlayer/babel` dosyalarınızı tarar ve `useIntlayer` / `getIntlayer` çağrılarını tree-shakeable sarmalayıcılarla (`useDictionary` / `useDictionaryDynamic`) değiştirir. Yalnızca seçilen koleksiyon öğesi, varyant veya dil (locale) için gerekli olan içerik yüklenir, böylece üretim (production) bundle'ınızın kullanılmayan çevirileri içermesi engellenir.
+Yükleyici, bir `docker-compose.yml` ve bir `.env` dosyasını indirir, gerekli gizli anahtarları otomatik olarak oluşturur ve `docker compose up -d` komutunu çalıştırır. Kontrol paneli, API, veritabanı, nesne depolama ve işlemsel e-posta dahil her şey yerel olarak kapsayıcılarda çalışır.
 
 ---
 
@@ -220,13 +371,17 @@ Derleme zamanında, `@intlayer/swc` ve `@intlayer/babel` dosyalarınızı tarar
 
 v8'den yükseltme yapıyorsanız, v9'un yıkıcı değişiklikler (breaking changes) içermediğini unutmayın. Ancak işte temel değişiklikler:
 
+- **Derleyici varsayılan olarak devre dışı**: `compiler.enabled` artık varsayılan olarak `false`'tur. `.content.ts` dosyalarınızın derleme zamanı çıkarımına güveniyorsanız, `intlayer.config.ts` dosyanızda `compiler.enabled: true` olarak ayarlayın.
 - **Diller ve Lehçeler (Locales & Dialects)**: Harici i18n bağımlılıkları kullanıyorsanız, içe aktarmaları otomatik olarak yeniden yazmak için yapılandırmanıza veya bundler kurulumunuza ilgili compat adapter eklentilerini ekleyin.
-- **Özel Seçiciler (Custom Selectors)**: `useIntlayer` çağrılırken, ikinci parametre artık `{ locale, item, variant, id }` içeren bir seçenek nesnesine ayrılmıştır. Daha önce doğrudan bir dil (locale) dizesi geçirdiyseniz bunu yapmaya devam edebilirsiniz, ancak gelişmiş seçimler için seçenekler nesnesini kullanmanız önerilir.
+- **Özel Seçiciler (Custom Selectors)**: `useIntlayer` çağrılırken, ikinci parametre artık `{ locale, item, variant }` içeren bir seçenek nesnesine ayrılmıştır. Daha önce doğrudan bir dil (locale) dizesi geçirdiyseniz bunu yapmaya devam edebilirsiniz, ancak gelişmiş seçimler için seçenekler nesnesini kullanmanız önerilir.
 
 ---
 
 ## Faydalı bağlantılar
 
 - [Compat Adapter Paketleri Kılavuzu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/compat/index.md)
-- [Dinamik Sözlükler - Koleksiyonlar, Varyantlar ve Dinamik Kayıtlar](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/index.md)
+- [Dinamik Sözlükler - Koleksiyonlar ve Varyantlar](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/index.md)
+- [Analytics - İçerik gösterim takibi ve A/B testi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [Yapılandırma Referansı](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md)
+- [CMS SDK - @intlayer/api ile programatik erişim](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_CMS.md)
+- [Kendi Sunucuda Barındırma Kılavuzu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/self_hosting.md)

package/docs/tr/roadmap.md

@@ -32,6 +32,12 @@ Intlayer, uygulamalarınızda içeriği bildirme, yönetme ve güncelleme şekli
 
 ---
 
+## İçindekiler
+
+<TOC/>
+
+---
+
 ## Mevcut Özellikler
 
 ### 1. İçerik Bildirimi