Doküman kimliği, çeviri ve redirect

Kimlik, kaynak ve URL

doc_id, source path ve URL farklı sorumluluklardır:

Alan	Görev	Değişebilir mi?
doc_id	Diller ve URL taşımaları boyunca kavramsal kimlik	Hayır
Source path	Ownership ve authoring konumu	Kontrollü olarak
Route	Okuyucunun yayın adresi	Redirect ile

doc_id küçük harfli audience prefix’iyle başlar. Geçerli örnekler user.reader.search, developer.api.rpc ve project.quality.corpus biçimidir. Aynı locale içinde iki sayfa aynı doc_id değerini kullanamaz. Başlık, locale veya URL değişikliği yeni kimlik üretmez.

Locale ve çeviri

Türkçe canonical ve prefixsizdir:

docs/user/getting-started.md -> /user/getting-started/

Diğer locale’ler lowercase BCP-47 dizininde audience’ı korur:

docs/locales/en/user/getting-started.md -> /en/user/getting-started/

Çeviri, Türkçe sayfayla aynı doc_id ve audience’ı kullanır. Canonical Türkçe sayfası olmayan çeviri kabul edilmez. Eksik çeviri başka dilde içerik varmış gibi sunulmaz; fallback davranışı ileride ayrıca ve görünür şekilde tasarlanır.

URL taşıma

Bir sayfa taşınırken doc_id korunur ve eski route yeni sayfaya eklenir:

redirect_from:
  - /developer/old-contract/

Redirect route’ları absolute, trailing slash’lı, küçük ASCII segmentli ve benzersizdir. Canonical route ile çakışamaz. Çeviri redirect’i kendi locale/audience namespace’i içinde kalır; Türkçe bir sayfa locale-prefix’li çeviri rotasını sahiplenemez. Build, root veya versioned base’i hedefleyen indexlenmeyen HTML redirect üretir ve mevcut artifact dosyasının üzerine yazmayı reddeder.

Değişikliği doğrulamak için make docs-check çalıştırılır. Yeni authored route browser suite’e validated content registry üzerinden otomatik katılır.