Wiki Bakimi

Wiki bakım rehberi ve sürüm değişiklik haritası

English · Türkçe · Languages / Diller

Kapsam: JSON API Forge 0.5.1 · İnceleme: 17 Eylül 2026 · Dil: Türkçe

Bu Wiki'nin bakım amacı yalnız üstteki sürüm rozetini değiştirmek değildir. Kullanıcıya görünür sözleşme, örnekler, alan varsayılanları ve bilinen sınırlar da yeni kaynakla uyumlu olmalıdır.

Yeni sürüm geldiğinde bu sohbet için bilgi

Şu kısa bilgileri vermeniz yeterlidir:

Yeni sürüm: 0.6.0
İncelenecek dallar: main, python-library, Editor, exampleApps
Varsa sabit commit/tag: ...
Değişiklik kapsamı: ...
Wiki'de özellikle bakılacak sayfalar: ...

Önceki Wiki paketi ve maintenance/source-map.json korunursa hangi sayfanın hangi dosyaya dayandığı görülebilir. Bu sohbette yeni değişiklikler gönderildiğinde eski/yeni sözleşme karşılaştırılır; gerekli sayfa ve örnek değişiklikleri somut olarak listelenir. Bu sayfa otomatik arka plan izleme işi kurmaz.

Değişiklik → sayfa haritası

Kaynak değişikliği	Güncellenecek sayfalar
main/framework/config.py, schemas/*	Proje ve JSON, ilgili özellik rehberi, bütün ilgili model referansları
framework/cli.py	CLI, kurulum, ilk API, init/migration örnekleri
security.py, protection.py, api_models.py	Auth, tenant, proxy, hata sözleşmesi, SDK örnekleri
crud.py, mongo.py, db.py	CRUD, MongoDB, DB/migration, pagination
operations.py	RPC, retry/idempotency, cluster sınırları
cache.py, rate_limit.py, events.py, media.py	İlgili işletme sayfası ve model alanları
reload.py, factory.py, runtime.py	Mimari, hot reload, readiness, dağıtım
editor_api.py, editor_identity.py, editor_database.py	Remote Editor, control-plane HTTP/model referansı, SDK contract
python-library/json_api_forge/*	SDK kılavuzları, tam imzalar, retry/cluster örnekleri
Editor/editor/src/GraphModel.cpp	Graph node/derleme tablosu, graph şeması
Editor UI/settings	Menü/kısayol, çalışma alanı ve prefs
Editor plugins/packaging	Plugin API/ZIP limitleri, ABI ve installer
Workflow/pyproject/CMake	Destek matrisi, kurulum, build/test/release
exampleApps/app/*	Katalog, örnek yollar ve ilgili tutorial
LICENSE/policy belgeleri	Lisans özeti ve resmi kaynak bağlantıları

Paket içindeki araçlar

maintenance/source-map.json, sayfa bağımlılıkları ve temel commitleri; maintenance/source-index.json, bütün izlenen dosyaların Git blob kimliklerini içerir. maintenance/review_changes.py yeni checkout/ref ile dosya farklarını ve etkilenen sayfaları raporlar:

git -C /path/to/JSON-API-Forge fetch origin
python maintenance/review_changes.py --repo /path/to/JSON-API-Forge --output wiki-impact.md

Depo bütün ürün dallarının remote ref'lerini içermelidir. Araç network isteği veya GitHub yazımı yapmaz. --ref main=origin/main gibi tekrar eden argümanlarla özel ref verilebilir. Eski commit geçmişten silinmiş olsa bile saklanan blob indeksiyle karşılaştırma yapılabilir.

Değişen dosyanın doğrudan sayfa bağımlılığı bulunamaması "Wiki etkilenmez" kanıtı değildir. Yeni endpoint veya property genel sözleşmeyi değiştirebilir; araç eşleşmeyen dosyaları ayrıca gösterir.

Her güncellemede kontrol

1. Yeni dört dal SHA'sını sabitleyin; sürüm beyanı ile gerçek release'i karşılaştırın.
2. Şema alanlarını ve SDK public signature'larını yeniden üretin; kaldırılan/yeniden adlandırılan alanları migration bölümüne yazın.
3. Tutorial'ı temiz ortamda çalıştırın; eski fixture'ların hatayı gizlemesine izin vermeyin.
4. İç linkleri, kaynak path'lerini ve büyük/küçük harfleri kontrol edin.
5. İlgili kaynakları/dependency haritasını ve VERIFICATION.md raporunu güncelleyin.
6. Wiki paketini tek normal Git commit'iyle yayımlayın; force push kullanmayın.

Eski sayfa adını mümkün olduğunca koruyun. Ad değiştirmek gerekiyorsa eski sayfada yeni sayfaya kısa geçiş bağlantısı bırakın. _Sidebar.md, Home ve İçindekiler bağlantılarını aynı güncellemede değiştirin.

Yayınlama

Wiki, ana depodan ayrı JSON-API-Forge.wiki.git Git deposudur. GitHub'da ilk Home sayfası oluşturulduktan sonra paket içindeki WIKI-YAYINLA.bat (Windows) veya publish-wiki.sh (Linux/macOS) sayfaları tek commit'le gönderir. Bu yardımcılar ana ürün dallarını merge etmez, force push yapmaz ve pakette olmayan mevcut Wiki sayfalarını silmez.

Yayın öncesi paketteki BASLA.md okunmalıdır. Git kimliğiniz ve mevcut GitHub credential manager oturumunuz kullanılır; script içine token yazılmaz. Eşzamanlı remote değişiklikte non-fast-forward push durur ve yerel kopya korunur.

İki dilin birlikte bakımı

Home ortak dil seçimidir; İngilizce başlangıç EN-Home, Türkçe başlangıç TR-Home sayfasıdır. Her belgenin başındaki bağlantı doğrudan aynı konunun diğer diline gider. Eski Türkçe konu adresleri korunur; İngilizce sayfalar EN- öneki taşır.

maintenance/language-map.json, 63 sayfa çiftini eşler. Teknik değişiklikte ilgili iki sayfayı birlikte güncelleyin. Kaynak etki haritası iki dili de kapsar; yeni sayfa eklenirse iki içerik, dil eşlemesi, içindekiler ve gezinme bağlantıları birlikte güncellenir. İngilizce kılavuz için START-HERE.md, yeniden üretim için maintenance/BUILD-BILINGUAL.md dosyasını okuyun.

Kaynak ve doğrulama

Bu sayfa aşağıdaki sabit commitlerdeki davranışı açıklar. Yeni bir sürümde aynı davranışın sürdüğünü varsaymayın.

• main/BRANCHES.md
• main/docs/README.md

---

Wiki ana sayfa · Tüm sayfalar · Sürüm ve bakım