murattunalı.

Alıntılanabilir pasaj nasıl yazılır.

Alıntılanabilir bir pasaj, sayfadan koparıldığında bile tek başına doğru ve anlaşılır kalan metin bölümüdür.

Yanıt motorlarında görünürlüğün teknik tarafı — erişim, yapı, şema — çözüldükten sonra geriye bir yazarlık işi kalır ve fark asıl orada oluşur. İki sitenin teknik altyapısı aynı olabilir; hangisinin alıntılandığını belirleyen şey, cümlelerin nasıl kurulduğudur.

Kural tek cümlede özetlenebilir: bir pasaj, sayfadan koparıldığında ayakta kalmalıdır. Model bir bölümü alıp yanıtına koyduğunda, o bölüm çevresindeki bağlamı yanında getirmez. Bağlama yaslanan her cümle, koparıldığı anda anlamsızlaşır.

Geri referanslar öldürür

Alıntılanabilirliği en çok bozan alışkanlık, geri referanstır: «yukarıda anlattığımız gibi», «bu yöntemin ilk adımında», «az önce bahsedilen sorun». Bunlar okuyucu için akıcılık sağlar ama alıntılandıklarında hiçbir şey ifade etmezler. Model, bağlamsız anlaşılmayan bir pasajı seçmekte tereddüt eder ve genelde başka bir kaynağa gider.

Çözüm, akıcılığı feda etmek değil, geri referansları kısa tekrarlarla değiştirmektir. «Yukarıda anlattığımız yöntem» yerine «kontrast oranı hesabı» yazmak, hem cümleyi bağımsız kılar hem de okuyucuyu yormaz. Tekrar, yazarlıkta genelde kusur sayılır; alıntılanabilirlik söz konusu olduğunda bir erdemdir.

  1. Kötü: «Bu yöntem çoğu durumda işe yarar.» — hangi yöntem?
  2. İyi: «Kontrast oranını token seviyesinde teste bağlamak, çoğu durumda kalıcı çözüm sağlar.»
  3. Kötü: «Yukarıda saydığımız üç kural yeterlidir.» — hangi kurallar?
  4. İyi: «Klavye erişimi, görünür odak ve alternatif metin — üçü A seviyesinin büyük kısmını kapatır.»
  5. Kötü: «Peki bunun için ne yapmalı?» — soru cümlesi bilgi taşımaz.
  6. İyi: «Hareket azaltma tercihine tam alternatif akışla cevap vermek, animasyonu kısmaktan güvenilirdir.»

İlk cümle kuralı

Bir bölümün ilk cümlesi, o bölümün alıntılanma şansını orantısız biçimde belirler. Model, kısa ve kendi başına doğru bir ifade arar; ilk cümle o role en yakın adaydır ve genelde ilk bakılan yerdir.

İyi bir ilk cümle üç iş yapar. Başlığın sorduğu soruyu cevaplar — tekrar etmez, cevaplar. Dışarıdan bağlam gerektirmez. Ve tek başına okunduğunda yanlış anlaşılmaz. Üçü sağlandığında cümle hem alıntılanabilir hem de okuyucu için iyi bir giriş olur.

Pratik bir test var: bölümün ilk cümlesini kopyalayıp başka bir yere yapıştırın ve okuyun. Hâlâ bir şey söylüyor mu, yoksa havada mı kalıyor? Havada kalıyorsa yeniden yazılmalıdır. Bu test on saniye sürer ve bir sayfadaki tüm bölümlere uygulanabilir.

Somutluk

Modeller doğrulanabilir ifadeleri tercih ediyor ve doğrulanabilirlik somutluktan geçiyor. Bir sayı, bir tarih, bir ölçüm ya da bir tanım içeren pasaj, aynı şeyi genel ifadelerle anlatan pasajdan belirgin biçimde daha sık alıntılanıyor. Sebebi muhtemelen çapraz doğrulama: somut bir iddia başka kaynaklarla karşılaştırılabilir, muğlak bir ifade karşılaştırılamaz.

Bu, içeriğin ne yazacağını da belirliyor. «Performans önemlidir» bir pasaj değildir; «gövde metni kâğıt zemine karşı 18,15:1 kontrast ölçüyor, AAA eşiği 7:1» bir pasajdır. İkincisi ölçülmüş, doğrulanabilir ve alıntılandığında ayakta kalır.

Ölçülmüş bir cümle alıntılanır; iddia edilmiş bir cümle atlanır.

Uzunluk

Alıntılanan pasajlar genelde kısadır — bir ya da iki cümle. Uzun paragraflar nadiren bütün olarak alınır; model ya bir parçasını keser ya da tamamen atlar. Bu, paragraf uzunluğu için pratik bir sınır getiriyor: bir fikir, bir paragraf, ve paragraf makul uzunlukta.

Ama kısalık tek başına yeterli değil. Kısa ve boş bir cümle — «bu konu önemlidir» — alıntılanmaz. Aranan şey, kısalık ile bilgi yoğunluğunun birlikte olmasıdır: az kelimede tam bir iddia.

Son bir hatırlatma: bunların hiçbiri model için özel bir numara değil. Bağımsız, somut ve kısa yazmak zaten iyi yazarlığın tarifi. Yanıt motoru döneminde değişen şey, bu disiplinin bedelinin ve getirisinin artmış olması.

Başlıkla pasajın ilişkisi

Alıntılanan pasajlar neredeyse her zaman bir başlığın hemen altında bulunur ve bu tesadüf değil: başlık, modelin pasajın hangi soruya cevap verdiğini anlamasını sağlar. Başlık soruyu tanımlar, ilk paragraf cevabı verir. Bu ikili, alıntılanabilir içeriğin temel birimidir.

Pratik sonuç, başlıkların da soru diliyle düşünülmesi gerektiğidir — mutlaka soru cümlesi olmaları gerekmez ama bir soruya karşılık gelmelidirler. «Uygulama detayları» bir başlık değildir; «Kontrast nasıl ölçülür» bir başlıktır. Birincisi hiçbir sorunun cevabı değildir, ikincisi bir sorunun tam karşılığıdır.

Bu, başlık hiyerarşisinin neden aynı anda üç okuyucuya birden hizmet ettiğini de açıklıyor: ekran okuyucu kullanıcısı için içindekiler tablosu, arama motoru için belge yapısı, yanıt motoru için pasaj sınırı. Tek bir disiplin, üç ayrı fayda.

Yapılandırılmış listeler

Numaralı ve maddeli listeler, alıntılanabilirlik açısından paragraflardan avantajlıdır çünkü zaten birimlere ayrılmışlardır. Model bir adım listesini bütün olarak alabilir ya da tek bir maddeyi çekebilir; her iki durumda da yapı korunur. Bu, «nasıl yapılır» tipindeki içerikte listelerin neden bu kadar sık alıntılandığını açıklıyor.

Ama listenin de bir disiplini var: her madde kendi içinde tam olmalıdır. «Önce ölç» yeterli değildir; «Kontrast oranını palet dosyasından hesapla, göz kararıyla bakma» tam bir maddedir. Yarım maddelerden oluşan bir liste, görsel olarak düzenli durur ama alıntılandığında hiçbir şey söylemez.

Bir de uzunluk sınırı var: on beş maddelik bir liste alıntılanmaz, kesilir. Beş ile sekiz madde arası, hem okunabilir hem alıntılanabilir bir aralıktır. Daha uzun bir liste gerekiyorsa, alt başlıklarla gruplamak hem okuyucuya hem modele yardım eder.

Ve son olarak, bu disiplinin sınırı: her şeyi alıntılanabilir yazmaya çalışmak metni kuru ve robotik hâle getirebilir. Bir yazının anlatı akışı, örnekleri ve tonu da değerlidir; okuyucu için yazılan bir metin, yalnız makine için yazılmış bir metinden her zaman iyidir. Doğru denge, KİLİT bölümleri bağımsız ve somut tutmak, aradaki bağlayıcı metni ise serbest bırakmaktır. Her paragrafın alıntılanması gerekmez — sayfanın cevap verdiği asıl sorunun cevabının alıntılanabilir olması yeter.

KAYNAKLAR