Kaynak Politikası

Bu sayfa bir çalışma kuralıdır. İki soruya cevap verir: bir cümle kaynak gerektiriyor mu, ve iki kaynak çeliştiğinde hangisi geçerli sayılır.

Birincil kaynak önceliği

Bir konuda birden çok kaynak varsa aşağıdaki sıra geçerlidir. Alttaki bir kaynak, üstteki bir kaynakla çelişiyorsa üstteki esas alınır.

1. Kanun ve ikincil mevzuat — Resmî Gazete metni esastır; haber ya da yorum değil.
2. Resmî kurum yayını — BTK, KVKK, HTK ve muadili kurumların kendi yayınları.
3. RFC / IETF — Protokol davranışının tanımı için birincil kaynak.
4. NIST, ENISA, ETSI, CISA — Standart, kılavuz ve terminoloji.
5. Akademik yayın — Hakemli olması ve yöntemin görünür olması aranır.
6. Üreticinin resmî dokümanı — Ürün davranışı için. Pazarlama sayfası değil, yönetici kılavuzu ve datasheet.
7. Labris resmî kaynağı — Labris ürünlerine dair her iddia için. Sürüm belirtilmesi zorunlu.

Genel blog yazıları, forum gönderileri ve üretici pazarlama sayfaları birincil teknik kaynak sayılmaz. Bir konu yalnızca bu tür kaynaklarda geçiyorsa o konuyu yazmayız. Yazmamak, zayıf dayanakla yazmaktan iyidir.

Kaynak bekleyen iddialar

Şu türden bir cümle kuruluyorsa arkasında adı verilen bir kaynak bulunur:

• Mevzuat hükmü ve süre
• Standart tanımı
• Sayısal performans değeri
• Sertifika ve belge
• Tarih
• Ürüne özgü özellik ya da davranış
• Teknik bir davranışın standart tanımı

Buna karşılık mimari muhakeme, işletim tavsiyesi ve kavram anlatımı kaynak gerektirmez; bunlar zaten metnin kendi gerekçesiyle ayakta durur. Kaynak listesi her sayfada bulunmak zorunda değildir — gerekmediği yerde konulması, gerektiği yerde konulmasının değerini düşürür.

Sayısal iddia ve ölçüm koşulu

Kaynağı gösterilmeyen oran ve rakam kullanılmaz. Performans değeri yazılıyorsa ölçümün hangi koşulda yapıldığı da yazılır: paket boyutu, akış sayısı, hangi modüller açık, hangi trafik profili. Koşulu verilmeyen bir throughput rakamı karşılaştırılabilir değildir. Öyleymiş gibi kullanmayız.

Mevzuat

Hukuki gereklilik ile teknik tavsiye birbirinden ayrı yazılır. Bir mimarinin mevzuata uygunluğu kolaylaştırması, uygunluğu garanti ettiği anlamına gelmez; hiçbir ürün için böyle bir garanti ifadesi kullanılmaz. Süre ve kapsam bilgileri ikincil düzenlemelerle değişebildiğinden, ilgili sayfalarda yürürlükteki metne bakılması gerektiği belirtilir.

Ürün iddiaları

Bir ürüne özgü davranış yazılmadan önce o ürünün ilgili resmî belgesi okunur ve hangi sürümden söz edildiği sayfada belirtilir. Eski sürüme ait bir sertifika ya da belge, güncel sürümün belgesi yerine kullanılmaz. Kamu kaynaklı katalog ve faaliyet kayıtları tarihsel kullanım kanıtıdır; güncel ürün özelliği olarak sunulmaz.

Düzeltme

Kaynağı yanlış anlaşılmış ya da güncelliğini yitirmiş bir iddia bildirildiğinde, düzeltme editoryal ilkelerde tarif edilen biçimde yapılır.