Geliştirici belgeleri

Bu ağaç, uygulama mimarisi, geliştirme ortamı, veri modeli, pipeline’lar, doğrulama sözleşmeleri ve operasyonel süreçler için canonical teknik dokümantasyon alanıdır.

Çalışan en kısa kurulumun canonical kopyası sample quick-start rehberidir. Root README.md yalnız aynı komutların kısa özetini taşır. Quick-start, committed exact Birinci Söz sample’ını Docker veya private artifact gerektirmeden normal reader üzerinden açar.

Dokümantasyon uygulamasının statik build, içerik ve sürümleme kararları için dokümantasyon altyapısı kaydına bakın. ADR ve veri modeli belgelerine mimari rehberden ulaşabilirsiniz. Execution registry denetim kaydıdır ve olağan geliştirici navigasyonunda yayımlanmaz.

Schema, API, pipeline ve teknik belgelerde kullanılan kimlik seviyeleri ile canonical machine key’ler için domain sözlüğünü kullanın.

Canonical Latin corpus ile çalışmaya başlamak için şu sırayı izleyin:

1. Sistem mimarisi ile authority katmanlarını, repository haritasını ve build/reader/curation akışlarını görün.
2. Core veri modeli ile immutable hierarchy, exact token occurrence ve annotation sınırını öğrenin.
3. Veritabanı kataloğu ile application şemalarını, authority sınırlarını, private routine’leri ve public RPC projection’ını bulun.
4. Veri provenance ve dönüşüm raporu ile source, process run, evidence, domain release ve deployment zincirini izleyin.
5. Kaynak dahil ve hariç raporu ile authority, candidate, evidence-only, curated extract ve excluded source’ları ayırın.
6. Corpus package ile core stream, companion, manifest ve import güven sınırını inceleyin.
7. Full data release ile tr-latn-1 artifact envanterini, dış checksum’ları, yayın ve doğrulama komutlarını bulun.
8. Temiz makinede yeniden üretilebilirlik ile public release’in temiz clone, disposable import ve exact reconstruction kapısını çalıştırın.
9. Backup, restore ve felaket kurtarma ile logical snapshot, checksum, fresh restore ve production aktivasyon sınırını uygulayın.
10. Release notes ile release candidate kapsamını ve teslim edilen artifact’leri görün.
11. Known limitations ile kapsam sınırlarını ve açık final release kapılarını kodlarıyla izleyin.
12. Release quality certificate ile kabul edilmiş kanıtların nasıl tek bir makine artifact’ine bağlandığını doğrulayın.
13. Güvenlik ve mahremiyet ile secret, bağımlılık, public artifact ve repository envanter denetiminin kapsamını görün.
14. Stable kimlikler ile deterministic UUID path’lerini ve kimlik değiştiren düzeltmeleri ayırın.
15. Atıf hedefi ve reference readiness ile authored hedef, exact/current resolution ve dil/tekrar projection sınırını öğrenin.
16. Exact reconstruction ile whitespace, punctuation ve source-order garantisini doğrulayın.
17. Yapısal annotation veri modeli ile shared span omurgası üzerinde segment, heading ve haşiye authority’lerini ayırın.
18. Osmanlıca ve lexical mimari ile mapping, rendering, terkip, lexeme, kök, lügat ve occurrence lookup katmanlarını izleyin.
19. Osmanlıca kaynak kalitesi ile source dahil/hariç partition’ını, curated catalog’u ve used-source closure’ı doğrulayın.
20. Osmanlıca API kataloğu ile private DB rutinlerinin exact imza, execution ve ACL gerçeklerini doğrulayın.
21. Tekrar keşfi ve canonical seçim mimarisi ile exact class, pending candidate, diff, review, canonical choice ve private reader authority’lerini birbirinden ayırın.
22. Çok dilli metin ve alignment mimarisi ile bağımsız dil sürümlerini, many-to-many grupları, review/coverage durumlarını, private reader’ı ve yeni dil ekleme sırasını öğrenin.
23. Veri düzeltmesi katkı rehberi ile stable hedef, kaynak kanıtı, deklaratif proposal, focused doğrulama ve production curation yetki sınırını izleyin.

Bu rehberlerdeki komutlar committed Birinci Söz sample fixture’ını veya disposable sample DB’yi kullanır. Full corpus release build’i olağan geliştirici doğrulaması değildir.

Pull request dokümantasyonunun secretsiz build ve trusted static deploy akışı için preview deployment rehberine bakın.

Exact main commitinin statik artifact olarak yayımlanması ve canlı link/arama smoke’u için production deployment rehberine bakın.

Accessibility, klavye, responsive navigation ve tema kalite kapılarını yerelde çalıştırmak için browser test rehberine bakın.

Kalıcı doc_id, locale kaynak düzeni, çeviri eşleme ve eski URL yönlendirmeleri için doküman kimliği rehberine bakın.

Audience seçimi, yazım, ownership ve kullanıcı/teknik içerik review’u için dokümantasyon yazım ve review rehberine bakın.

Execution packet, ayrı worktree, write-set ve kontrollü merge sırası için packet ve merge akışı rehberine bakın.

PostgreSQL rol sınırları, loopback exposure kapısı ve packet başına disposable veritabanı yaşam döngüsü için veritabanı erişimi ve ajan izolasyonu rehberine bakın.