Yazım ve iddialar

İngilizce kaynak sade ve düz cümlelerle, İngiliz İngilizcesiyle yazılır; Türkçe de aynı ses tonunu korur. Metnin çoğu Zerone adına "biz" diye konuşur ve okura "siz" diye seslenir. Bir cümle bir şeyin ne yaptığını söyler ve orada durur. Bu bölümdeki kalıpları hiçbir test korumuyor; her biri incelemeyle korunan bir teamüldür ve aşağıdaki sayılar her derlemede ölçülür.

Sözlüklerden ölçüldü.

Her sayfanın metni bir İngilizce ve bir Türkçe sözlükte durur; araştırma yazıları ve yasal metinler Markdown dosyalarıdır ve burada sayılmaz. Bu sayılar site derlenirken, bu bölümün dışındaki sözlüklerden sayılır; metin değişince onlar da değişir.

Noktayla biten başlıklar

36/36

Sayfa başlıkları, iki dilde.

Ünlem işareti

0

İki dildeki 2.754 metnin tamamında.

İngilizcede kesme işaretli kısa biçim

0

İngilizce metinde fiiller kısaltılmadan, açık yazılır.

Siz ve biz

131 · 111

İngilizce metin okura 131 kez seslenir, Zerone adına 111 kez konuşur.

Kullanımdaki başlıklar

Kısa, düz ve noktayla biten cümleler: aşağıdaki sayfalarda İngilizcede 3 ile 12 sözcük arası. Türkçe başlık sözcük sözcük çevrilmez; Türkçe okur için yeniden yazılır.

Yazım ve şahıs

• İngilizce metin İngiliz yazımıyla yazılır.

  NedenAkan metinde ve adlarda tek yazım sistemi: İngilizce sayfalarda güven sayfasına giden alt bilgi bağlantısı da, çerçeve listesindeki NATO kaydı da İngiliz yazımıyla yazılır. Bir üreticinin kendi terimi ise kendi yazımını korur; İngilizce ürün sayfasındaki Windows terimi "catalog signature" gibi. Yüzde de derlemenin işaret yerine istediği biçimde, tek sözcük olarak yazılır.

  İncelemeBir testle değil, incelemeyle korunur.

• "Biz" diye konuşun, okura "siz" diye seslenin.

  NedenZerone "biz", okur "siz"dir; böylece cümle kimin ne yaptığını söyler. Şirket adı, Zerone'u tanıttığı yerde üçüncü şahısla geçer; ana sayfa ve şirket sayfası öyle yapar.

  İncelemeBir testle değil, incelemeyle korunur.

Cümleler

• Yeteneği anlatın; üstünlük sıfatlarını dışarıda bırakın.

  NedenBir yetenek ürünle karşılaştırılıp doğrulanabilir. Bir sıfat doğrulanamaz ve güvenlik alıcısı onu daha okurken eler.

  İncelemeBir testle değil, incelemeyle korunur.

• İngilizcede kesme işaretli kısa biçimler, iki dilde de ünlem işareti kullanılmaz.

  NedenAçık yazılmış biçim sayfada, raporda ve sözleşmede aynı okunur. Vurguyu cümlenin söylediği şey taşır.

  İncelemeBir testle değil, incelemeyle korunur.

• "Bu değil, şu" karşıtlığını yalnızca asıl noktayı taşıdığı yerde kullanın.

  NedenSitenin imza kalıbıdır: "Dosyalarınız değil, meta veri ve özetler". Her paragrafta kullanılırsa anlamını yitirir.

  İncelemeBir testle değil, incelemeyle korunur.

• Bir kategoriyle karşılaştırın, adı verilmiş bir rakiple asla.

  NedenPazar değişse de karşılaştırma doğru kalır. Ürün sayfasından: "Dosya bütünlüğü araçları bir dosyanın değiştiğini söyler. Zero Door diskteki dosyanın, yayımcısının gönderdiği dosya olup olmadığını söyler; sunucudaki her ikili dosya, kütüphane ve paket için, işletim sistemiyle gelen her şey dahil."

  İncelemeBir testle değil, incelemeyle korunur.

Noktalama

• İngilizce listelerde son bağlaçtan önce virgül konmaz.

  NedenAna sayfanın yazdığı gibi: "ikiliyi, kütüphaneyi ve paketi". İngilizce metin bunu henüz her yerde izlemiyor: 50 İngilizce metin listenin son bağlacından önce virgül koyar; sayım her derlemede desene göre yapılır.

  İncelemeBir testle değil, incelemeyle korunur.

• Cümle olan başlık noktayla biter; üst başlıklar, düğmeler ve etiketler nokta almaz.

  NedenNokta bir önermeyi işaretler. Etiket bir addır, düğme bir eylemdir.

  İncelemeBir testle değil, incelemeyle korunur.

İddia, bir alıcının bizi sorumlu tutabileceği cümledir. Yetenek cümleleri ürün koduyla karşılaştırılır; kodun karşılamadığı bir cümle düzeltilir ya da kaldırılır. Kodda karşılığı olmayan bir yetenek hiç yazılmaz.

Bugün olanı yazın.

Ürün, bir dosyanın onu yayımlaması gereken tarafça yayımlanmış orijinal olup olmadığına karar verir; bu, dosyanın nereden geldiğine dair bir önermedir, niyetine dair değil. Site müşteri logoları yerine okurun kendisinin doğrulayabileceği kanıtı sunar; örneğin denetçinin çevrimdışı doğruladığı kanıt.

• Ürünün bugün ne yaptığını, kodunun yaptığı biçimde anlatın. Planlananı asla.

  NedenBir pilot bunu haftalar içinde ortaya çıkarır. Ürünün karşılayamadığı bir cümle, kazandırdığından fazlasını kaybettirir.

  İncelemeBir testle değil, incelemeyle korunur.

• Bir dosya için orijinaliyle aynı ya da yayımcısından geliyor deyin. "Meşru" sözcüğünü "güvenli" yerine kullanmayın.

  NedenEle geçirilmiş bir yapı, yayımcısının yayımladığıyla birebir aynı bir paketin içinde gelebilir.

  İncelemeBir testle değil, incelemeyle korunur.

• Müşteri logosu yok, vaka çalışması yok, belli sayıda sunucusu olan bir banka gibi isimsiz profil yok.

  NedenKimsenin doğrulayamayacağı bir kanıt, şirket ve kariyer sayfalarının tekrarladığı "iddia değil kanıt" kuralıyla çelişir. Ürünün neyi yapmadığı bunun yerine mimari sayfasında ve her çözüm sayfasında söylenir.

  İncelemeBir testle değil, incelemeyle korunur.

Eşleme sertifika değildir.

Ürün kanıtını kontrol kataloglarına eşler. Güven sayfası bu sözcüğü her okur için tanımlar:

On üç çerçeve hazır gelir. Eşleme, denetim izinin ve raporların bu kontrollere göre düzenlendiği anlamına gelir. Zerone'un her çerçeve için sertifika taşıdığı anlamına gelmez; sertifikalar alındığında burada listelenir.

• Yalnızca ürünün getirdiği çerçeveleri anın; adları sitenin tek çerçeve listesinden alın.

  NedenHer iddia sayfasının ana içeriği, ürünün getirmediği 6 katalog adı için taranır; biri bulunursa derleme başarısız olur. Denetim bu adları aynı dosyadan okur; kullanılacak adlar ile kaçınılacak adlar tek yerde durur. Adların sayfalarda bu listeden alınması ise incelemeyle korunur.

  TestHer değişiklikte bir testle korunur.

• Liste bir birim testinde sabitlenmiştir.

  NedenTest, ürün kataloğundan kopyalanmış 13 kimliği sabit bir sırayla tutar. Ürün tarafındaki bir değişikliği test değil, inceleme yakalar.

  TestHer değişiklikte bir testle korunur.

• Ne ürün ne de Zerone için sertifika ya da akreditasyon iddia etmeyin.

  NedenÜrün, denetçinin kullandığı kanıtı üretir. Değerlendirme de, varsa sertifika da denetçinindir.

  İncelemeBir testle değil, incelemeyle korunur.

Derleme yüzde işaretinin yanında tek bir sayı kabul eder: her kademede aynı olan aylık erişilebilirlik, yani 99,5. Diğer her sayı ya kodla doğrulanmış bir ürün gerçeği, ya bir sözleşme koşulu, ya tarihli bir ölçüm ya da "hedef senaryo" diye etiketlenmiş bir öngörüdür.

• Yüzde işaretinin yanında yer alabilecek tek sayı 99,5'tir: İngilizcede 99.5%, Türkçede %99,5.

  NedenBurada adı geçen ortak sözlük testi ve her sayfa sözlüğünün kendi testi, her metni yüzde işaretinin yanındaki sayı için tarar; başka bir değer testi başarısız kılar. Aynı denetim derlenen her sayfada yeniden çalışır.

  TestHer değişiklikte bir testle korunur.

/(\d+(?:[.,]\d+)?)\s?%|%\s?(\d+(?:[.,]\d+)?)/g

Bir sayı nereden geldiğini söyler.

Ölçülmüş sayı ürün sayfasının kanıt şeridinde durur ve etiketi ölçüldüğü ayla biter; aynı sayfanın aşağısındaki güncelleme görseli aynı kaydı okuyarak aynı sayıya kadar sayar. Ana sayfada ölçülmüş sayı yok, yalnızca bir öngörü var; öngörü de bir pilotta ölçülene kadar "hedef senaryo" ibaresini taşır.

• Her sayıyı kaynağıyla etiketleyin: ölçüm için ay, öngörü için "hedef senaryo".

  NedenSayı, bir sayfanın en çok alıntılanan parçasıdır. Etiketi olmadan bir söz gibi okunur.

  İncelemeBir testle değil, incelemeyle korunur.

Diğer nicelikler

Bir oranın söylenmesi gerekiyorsa işaret yerine yüzde sözcüğü yazılır ve sayı ürünle doğrulanır. Başlıklardaki sayılar aşağıdaki gibi yazıyla yazılır; rakam kullanan tek başlık İngilizce 404 sayfasının başlığıdır: "0 results, 1 way home". Bu bir kural değil, gözlemdir.

• Bir sayı bir ürün gerçeği, bir sözleşme koşulu, tarihli bir ölçüm ya da etiketli bir öngörüdür.

  NedenUydurma bir metrik sayfadaki diğer sayılar gibi okunur. Bu yüzden hiç yazılmaz.

  İncelemeBir testle değil, incelemeyle korunur.

• Fiyat sayfası lisans modelini anlatır ve fiyat vermez: liste fiyatı yok, sunucu başına fiyat yok, deneme süresi yok.

  NedenModel tam olarak anlatılabilir ve bir sözleşmeyle karşılaştırılabilir. Sayfadaki bir liste fiyatı karşılaştırılamaz.

  İncelemeBir testle değil, incelemeyle korunur.

Her dil sayıları kendi biçimiyle yazar. Sayıların çoğu her sözlükte elle yazılır; araştırma tarihlerini ve ürün sayfasındaki güncelleme sayacını ise kod, sayfanın diliyle biçimlendirir.

const fmt = new Intl.NumberFormat(document.documentElement.lang || 'en');

Araştırma sayfalarının bastığı biçimde bir tarih

Araştırma tarihleri İngilizce sayfalarda en-GB, Türkçe sayfalarda tr-TR ile biçimlenir; ikisi de günü başa koyar. Tarih mono yazı tipiyle, datetime özniteliği ISO tarihini tutan bir time öğesinin içinde durur.

const dateLocale = locale === 'tr' ? 'tr-TR' : 'en-GB';
<time class="date" datetime={p.data.pubDate.toISOString().slice(0, 10)}>{p.data.pubDate.toLocaleDateString(dateLocale)}</time>

• Araştırma tarihleri İngilizcede en-GB, Türkçede tr-TR kullanır; datetime özniteliğinde ISO tarihi durur.

  Nedenİki dilde de gün önce gelir ve altta makinenin okuduğu tek bir biçim vardır. Bir birim testi, araştırma tarihi basan üç bileşeni bu yerel ayarlara bağlar.

  TestHer değişiklikte bir testle korunur.

Henüz netleşmeyenler

Üç tarih biçimi kullanımda: araştırma tarihleri günü başa koyar, yasal metinler ve bu sayfaların Son değişiklik satırı ISO tarihini saklandığı gibi basar, İngilizce konsol ise ayı başa koyan en-US biçimini kullanır. Araştırma tarihi ayrıca derleme makinesinin saat diliminde biçimlenir, datetime özniteliği ise UTC gününü tutar; UTC'nin batısında yapılan bir derleme bir önceki günü basar.

Ürünün adı Zero Door'dur: iki sözcük. Şirket, metin içinde Zerone, bir site adının beklendiği yerde Zerone Security olarak geçer.

• Ürün adını iki sözcük olarak yazın: Zero Door.

  NedenHer sözlük metni ve derlenen her sayfa, harf büyüklüğü ne olursa olsun bitişik yazım için taranır; alan adı ya da çerez adı gibi tamamı küçük harfli bir makine adı geçer. Her sayfa sözlüğünün kendi testi vardır; burada adı geçen, bu sayfayı denetler.

  TestHer değişiklikte bir testle korunur.

• İngilizce metinde adın önüne tanımlık gelmez. Tanımlık yalnızca ad bir ismi nitelediğinde, o isme ait olarak gelir.

  NedenÜrün adı özel addır. Bir ismi nitelediğinde o ismin tanımlığını alır.

  İncelemeBir testle değil, incelemeyle korunur.

Kullanımdaki adlar

Şirketin tescilli unvanı künye metninde ve her sayfanın yapılandırılmış verisinde yer alır; sicil bilgileri yalnızca künyededir. İkisi de metnin içinde geçmez.

• Slogan iki dilde de İngilizce kalır.

  NedenSlogan bir addır, çevrilecek bir cümle değil. Üst başlık olarak her üst başlık gibi noktasızdır; alt bilgide bir cümle olarak durur ve noktayla biter.

  İncelemeBir testle değil, incelemeyle korunur.

Bazı dizeler nerede geçerse geçsin derlemeyi başarısız kılar. Testler her sözlük metnini okur; derleme denetimleri de derlenen her sayfayı alt, title, aria-label ve meta metinleri dahil okur, bağlantı ve kaynak adresleri atlanır. Bu yüzden bu sayfa reddedilen dizeleri basmaz, tarif eder.

Bir cümle deneyin.

Bu kutu, derlemenin dört dize denetiminin aynısını siz yazarken tarayıcınızda çalıştırır. Çerçeve denetimi bu sayfanın basamayacağı bir ad listesini okur; bu yüzden derlemede kalır.

İki cümleyi bağlamak

Uzun tire olmadan bu işi virgül, iki nokta, noktalı virgül ya da nokta görür. Orta nokta bir başlığın ya da etiketin parçalarını ayırır.

Büyük harf

Başlıklarda, düğmelerde ve etiketlerde yalnızca ilk sözcüğün ve özel adların baş harfi büyük yazılır; yukarıdaki başlıklar da öyledir. Üst başlık sözlükte bu biçimde saklanır ve büyük harfe stil dosyası çevirir; stil dosyası bunu öğenin diline göre yapar: Türkçe i ancak lang="tr" altında noktalı büyük İ olur.

@utility kick {
  font-family: var(--font-mono); font-size: 11px; letter-spacing: 0.12em;
  text-transform: uppercase; color: var(--color-ink-subtle);
}

• Üst başlığı sözlükte olağan yazımıyla saklayın; büyük harfleri stil dosyasına bırakın.

  NedenElle yazılmış büyük harf, dizenin yeniden kullanıldığı her yerde, bir sayfa başlığında ya da bağlantı önizlemesinde de büyük kalır. Stil dosyası yalnızca tasarımın istediği yerde ve öğenin diline göre büyütür.

  İncelemeBir testle değil, incelemeyle korunur.

Kısaltmalar

İngilizce metinde üç ya da daha çok büyük harften oluşan 56 farklı kısaltma geçer; en sık kullanılanlar DSS, PCI, GDPR, ISO ve NIST. Kısaltmalar okurun alanının yazdığı gibi kalır, Türkçe metinde de; sözlük, alıcının ilk karşılaştıklarını tanımlar, örneğin CVE.

• Kısaltmayı alanının yazdığı gibi yazın; alıcının bilmeyebileceği yerde sözlük onu açar.

  NedenGüvenlik okuru açılımını değil, kısaltmanın kendisini arar.

  İncelemeBir testle değil, incelemeyle korunur.

Metin alternatifleri

Anlam taşıyan bir çizimin sözlükte tek cümlelik bir etiketi vardır ve etiket önce ne olduğunu söyler: 17 Türkçe etiket "Çizim:" ile başlar; İngilizceleri de aynı biçimde açılır.

• Anlam taşıyan bir çizime tek cümlelik bir etiket verin.

  NedenEkran okuyucu resmin yerine etiketi okur. Uçtan uca bir test /, /zero-door, /services, /trust, /research, /architecture ve /design/visualisation sayfalarını iki dilde açar ve her görsel etiketini okur; 40 karakteri geçmeyen ya da noktayla bitmeyen etiketi reddeder.

  TestHer değişiklikte bir testle korunur.

• Etikete ne olduğunu söyleyerek başlayın.

  NedenDinleyen kişi önce bir resmin anlatıldığını, sonra resmin ne gösterdiğini öğrenir.

  İncelemeBir testle değil, incelemeyle korunur.

Tırnak ve kesme işaretleri

Bir addan sonra gelen Türkçe ek düz kesme işaretinden sonra gelir, örneğin Zero Door'u: Türkçe metinde harfler arasında 41 düz ve 0 kıvrık kesme işareti var; ülke ifadesi denetimi de yalnızca düz biçimi eşleştirir. Türkçe sözlük alıntılanan bir soruyu düz çift tırnak içine alır.

• Sözcüğün kendisinden söz ederken onu tırnak içine alın: Türkçede çift, İngilizcede tek tırnak.

  NedenTırnak olmadan "henüz" ya da "bugün" deyin gibi bir kural yazım hatası gibi okunur. Bu sayfa böyle yazar; sitenin geri kalanı bir sözcükten pek söz etmez.

  İncelemeBir testle değil, incelemeyle korunur.

Mimari sayfası ve her çözüm sayfası bir Sınırlar listesi taşır: ürünün yapmadığı şeyler, sade cümlelerle. Mimari sayfası nedenini listenin üstündeki tek satırda verir.

• Mimari sayfası bir Sınırlar listesi taşır.

  NedenUçtan uca bir test sayfayı iki dilde açar; listede 5 maddeden az varsa başarısız olur.

  TestHer değişiklikte bir testle korunur.

• Her çözüm sayfası da bir tane taşır.

  NedenAynı dosya 4 sektörün her biri için iki dilde bir test çalıştırır ve en az 3 madde bekler.

  TestHer değişiklikte bir testle korunur.

• Bir eksiklik bugüne aitse ve değişebilecekse bunu "henüz", "şu anda" ya da "bugün" ile söyleyin. Saklamayın ve tarih vermeyin.

  NedenBu sözcük boşluğun gerçek ve bugüne ait olduğunu söyler. Tarih bir yol haritası iddiası olur; site yalnızca ürünle geleni anlatır.

  İncelemeBir testle değil, incelemeyle korunur.

Bir ifade, hep aynı.

Sınırı çerçeveleyen cümle, "Tespit eder, açıklar ve kanıtlar", 4 Sınırlar maddesinde birebir aynı kalır; ardından gelen sınır her sayfa için ayrı yazılır. /solutions/healthcare sayfası sınırlarını bu cümle olmadan söyler.

Sözlük, okurun sitede karşılaştığı sözcükleri açıklar. Tanım terimle ilgilidir. Terim yaptığımız şeye değiyorsa, altındaki tek bağlantı iddianın sitede gösterildiği yere götürür.

• Tanım terimi açıklar. Ürünün ne yaptığını asla söylemez.

  NedenSatış yapan bir sözlük artık sözlük olarak okunmaz. Ürün yalnızca bağlantının arkasında görünür.

  İncelemeBir testle değil, incelemeyle korunur.

• Bir terimin en fazla bir bağlantısı olur ve bağlantı açılmalıdır.

  NedenMadde türü tek bir bağlantıya izin verir. Derlenen her sayfadaki her iç bağlantı ve çapa denetlenir; olmayan bir bölüme giden bağlantı derlemeyi başarısız kılar.

  TestHer değişiklikte bir testle korunur.

• Yalnızca okurun sitede karşılaştığı terimler; satmadığımız bir yeteneğin terimi yok.

  NedenÜrünün yapmadığı bir şeyin tanımı, onu yaptığını ima eder.

  İncelemeBir testle değil, incelemeyle korunur.

• Bir araştırma yazısı bir sözlük terimine bir kez, düz metinde ilk geçtiği yerde bağlanır.

  NedenBaşlıklar, kod, alıntılar, görsel açıklamaları ve tablolar atlanır; bağlantılar okura yardım eder, yazıyı bir bağlantı listesine çevirmez.

  TestHer değişiklikte bir testle korunur.

İngilizce kaynaktır ve kökte durur. Türkçe, aynı yollarla /tr/ altında elle yazılır. İkisi de makine çevirisi değildir ve iki sözlüğün yapısı birebir aynı olmak zorundadır.

İki tarafta aynı anahtarlar.

Her Türkçe sözlük, İngilizce sözlüğün türüyle tanımlanır; eksik bir anahtar tür denetiminde yakalanır. Ardından bir test iki yapıyı çalışma zamanında, her dizinin uzunluğuna kadar yeniden karşılaştırır.

const tr: typeof en = {

• Türkçe sözlük, İngilizce sözlüğün birebir yapısındadır.

  NedenEksik bir anahtar bir dilde boşluk gösterir, fazlası hiç okunmaz. Her sayfa sözlüğünün kendi testi vardır; burada adı geçen, bu sayfayı denetler.

  TestHer değişiklikte bir testle korunur.

• Gezinmenin, alt bilginin ve ana sayfanın ortak sözlüğü de aynı kurala uyar.

  NedenTesti Türkçe sözlüğün tamamını İngilizce sözlükle karşılaştırır.

  TestHer değişiklikte bir testle korunur.

• Türkçe, İngilizce kaynaktan elle yazılır. Makine çevirisi asla yayına çıkmaz.

  NedenTürkçe okur, Türkçe bir yazarın kuracağı cümleyle karşılaşmalı; Türkçe sözcüklerle yazılmış İngilizce bir cümleyle değil.

  İncelemeBir testle değil, incelemeyle korunur.

Türkçe sayfada İngilizce

Türkçe bir sayfada İngilizce kalan bir ifade lang="en" taşımalıdır; ekran okuyucu böylece söyleyişini değiştirir. Araştırma yazıları İngilizce yazılır ve Türkçe sayfa çerçevesinin içinde lang="en" ile işaretlenmiş bir makale olarak durur.

Slogan da bu özniteliği taşır: ana sayfanın üst başlığında, alt bilgide ve şirket sayfasında.

<span class="kick" lang={locale === 'tr' ? 'en' : undefined}>{d.hero.kick}</span>

• Türkçe sayfada kalan İngilizce lang="en" taşır.

  NedenÖznitelik olmadan ekran okuyucu İngilizce sözcükleri Türkçe kurallarla okur.

  İncelemeBir testle değil, incelemeyle korunur.

• Türkçe ana sayfada hero üst başlığı ve güven şeridi lang="en" taşır.

  NedenUçtan uca bir test Türkçe ana sayfayı açar ve iki özniteliği de denetler. Diğer sayfaları inceleme korur.

  TestHer değişiklikte bir testle korunur.

• Türkçe sayfadaki İngilizce bir makale bütünüyle İngilizce olarak işaretlenir.

  NedenÇerçeve Türkçe kalır; gövde lang="en" taşıyan tek bir makale öğesidir.

  TestHer değişiklikte bir testle korunur.

• Türkçe okura siz diye seslenir; eylem çağrıları kibar emir kipini kullanır.

  NedenResmi hitap, İngilizce metnin okura sesleniş biçimiyle örtüşür ve bir form gibi okunmaz. Bazı kısa bağlantı etiketleri şu anda yalın biçimi kullanır.

  İncelemeBir testle değil, incelemeyle korunur.

Bazı İngilizce terimlerin sitenin her sayfasında tek bir Türkçe karşılığı vardır. Burada yalnızca metnin zaten tek biçimde kullandığı terimler yer alır; sayılar her derlemede Türkçe sözlüklerden alınır.

Henüz netleşmeyenler

Bu sayfanın izlediği terimlerin hiçbiri bugün iki Türkçe biçimle kullanılmıyor; hepsi yukarıdaki tabloda. Bir terimin başka bir biçimi varsa sayısı son sütunda durur.