Geliştiricilerin Okuduğu Blog Yazıları Nasıl Yazılır

• Geliştiricilerin gerçekten okuyup paylaştığı blog yazılarının nasıl yazılacağına dair pratik bir rehber
• Yazar, 9 yıllık yazılım blogculuğu deneyimine ve milyonlarca görüntülenmeye dayanarak başarılı gönderilerle başarısız gönderiler arasındaki farkı analiz ediyor
• Hacker News, Reddit, Lobsters gibi geliştirici topluluklarında öne çıkan yazıların ortak noktalarını ve stratejilerini anlatıyor

Neden yazara güvenebilirsiniz

• Yazar 9 yıldır kişisel bir geliştirici blogu yürütüyor ve yılda 300 bin ila 500 bin okuyucu ziyaret ediyor
• Hacker News ana sayfasında 30'dan fazla kez yer aldı; bunların çoğu 1. sıraya çıktı
• Tek bir blog yazısıyla başarılı bir indie business başlattı
• Reddit ve Lobsters gibi platformlarda da düzenli olarak anılıyor
• Hacker News üzerinde en popüler 48. kişisel blog olarak değerlendiriliyor

Ana fikri hızla iletmek

• Birçok geliştirici blog yazarı yazının başında konuya doğrudan girmediği için okur kaybına yol açıyor
• Okur yazıyı okumaya başlarken iki soruya yanıt bekler:
  • Bu yazı benim gibi biri için mi?
  • Bu yazıyı okuyarak ne kazanacağım?
• Bu iki sorunun yanıtı başlıkta ve ilk 3 cümlede verilmelidir
• Okurun ilgisini çekecek konuları ve terimleri kullanmalı, aşırı teknik jargon ya da uzun arka plan açıklamalarından kaçınmalısınız
• Yazının sunduğu kazanım şunlardan biri olabilir:
  • Günlük hayatta veya işte hemen uygulanabilecek teknikler
  • Anlaması kolay kavram açıklamaları
  • Teknoloji ya da sektöre dair içgörüler
  • Bağ kurulabilen ilgi çekici bir hikâye

• Örnek: “if got, want: A Simple Way to Write Better Go Tests”

  • Başlık ve ilk cümle tek başına şunları netleştiriyor:
    • Hedef okur: Go dili kullanıcıları
    • Kazanım: 30 saniye içinde yeni bir test yazma yaklaşımı öğrenmek

Hedef okur kitlesi nasıl genişletilir

• Çoğu blog yazarı yazılarını belirli ve küçük bir geliştirici grubunu hedefleyerek yazar (ör. orta-ileri seviye Java geliştiricileri)
• İfadelerde yapılacak küçük değişikliklerle çok daha geniş bir okur kitlesine ulaşılabilir (ör. tüm Java geliştiricileri → tüm geliştiriciler → teknolojiye ilgi duyanlar)
• Arka plan bilgisi olmayan okurların da anlayabilmesi için terimlerde ve açıklamalarda yapılacak ufak ayarlamalar erişimi 10 kat artırabilir
• Ancak aşırı genelleştirme yazının derinliğini ya da uzmanlık düzeyini düşürebilir

• Örnek: “How I Stole Your Siacoin”

  • Başlangıçta belirli bir kripto para topluluğunu hedefleyen bir yazıydı
  • Terimler ve açıklamalar genelleştirilerek kripto parayı bilmeyenlerin de anlayabileceği hâle getirildi
  • Sonuçta Reddit, Hacker News ve başka topluluklarda popüler oldu

Okura ulaşacak yolu planlamak

• Yazıyı iyi yazmış olsanız bile kimse okumuyorsa bunun bir faydası yoktur
• Google aramalarında üst sıralara çıkması zor olan konulardan kaçınmalısınız
• Topluluklarda (ör. Reddit, Hacker News vb.) paylaşım için gerçekçi bir plan gerekir
• Reddit gibi yerlerde dış bağlantılara izin verilmeyebilir ya da çok katı kurallar olabilir
• Hacker News çoğu zaman tutorial'lara veya fazla sıradan konulara soğuk yaklaşır
• Sosyal medyada paylaşsanız bile çok sayıda takipçiniz yoksa etkisi sınırlı kalır

• Gerçekçi bir dağıtım yolu tasarlamak gerekir

  • Konu seçmeden önce yazının hangi yolla okura ulaşabileceğini düşünmelisiniz
  • Şu soruları değerlendirin:
    • Google aramasıyla kolayca bulunabilecek bir konu mu?
    • Zaten yüzlerce yazının bulunduğu bir konu değil mi?
    • Hedef okur hangi anahtar kelimeleri arar?
    • Bağlantıyı paylaşabileceğiniz bir topluluk var mı? Bu topluluk aktif mi?

• Örnek: “Using Zig to Unit Test a C Application”

  • Zig yeni bir teknoloji olduğu için rakip yazı neredeyse yoktu ve arama sonuçlarında üst sıralara çıkmayı başardı
  • Bağlantı Hacker News, Lobsters, Reddit (/r/Zig), Ziggit gibi yerlerde paylaşılabildi
  • Sonuç olarak tüm kanallarda üst sıralarda popüler oldu

Daha fazla görsel unsur göstermek

• Blog yazılarında en etkili değişiklik görsel eklemektir
• Yalnızca uzun metinden oluşan yazıların okunabilirliği düşer
• Şu durumlarda görsel, ekran görüntüsü, grafik vb. eklemek faydalıdır:
  • GUI programı anlatımı → ekran görüntüsü
  • Sayısal değişimi anlatma → grafik
  • Sunucu hatası gibi bir olayı anlatma → dashboard görüntüsü
  • Karmaşık kavramları açıklama → şema, diyagram
• Basit çizimler için Excalidraw gibi ücretsiz araçlar kullanılabilir
• Bir illüstratör tutmak da iyi bir yöntem olabilir (illüstrasyon başına yaklaşık $50~100)
• Bazen yapay zeka görselleri yerine MS Paint tarzı basit çizimler daha etkili olabilir

Göz gezdiren okurlar için yapı tasarlamak

• Birçok okur yazıyı baştan sona okumaz; göz gezdirerek karar verir
• Yalnızca göz gezdirmeyle ilgi uyandırmak için şu unsurlar önemlidir:
  • Açık ve ilgi çekici başlıklar
  • Uygun görseller ve görsel ipuçları
  • Yalnızca metinden oluşan uzun paragraflardan kaçınmak

• Araç: yazıya göz gezdirme açısından bakmak

  • Bir bookmarklet kullanarak yazıda yalnızca başlıkların ve görsellerin görünmesini sağlayabilirsiniz
  • Böylece göz gezdiren bir okurun gördüğü yapıyı kontrol edebilirsiniz

• Örnek: sıkıcı yapılı yazı vs. ilgi çekici yazı

  • “End-to-End Testing Web Apps: The Painless Way” → başlıklar ve görseller yeterince çekici olmadığı için başarısız oldu
  • “I Regret My $46k Website Redesign” → görsel yapı ilgi çekti ve başarılı oldu (ilk haftada 150 bin kişi okudu)

[GN⁺]

Hacker News yorumu

• Genel olarak blog yazısı yazarken ters piramit yapısı en uygun yaklaşım. Yazının ana fikrini hızlıca vermek, ardından ayrıntılara girmek önemli. Böylece okur yazıyı yarıda bıraksa bile önemli noktaları kaçırmaz

  • Okur bulma sorununda en iyi çözüm şeffaflığı korumaktır. Ters piramit biçimi bunu sağlar. İlgilenmeyen insanları çekmeye çalışmanın anlamı yok. Mevcut okurları elde tutmak, yeni okur çekmekten daha önemlidir
  • Görsel kullanımına karşı şüpheciyim. Metinle yakından ilişkili değilse gereksiz görseller iyi değildir. Görsel gürültüyü azaltmak önemlidir. Görseller asla komik olmamalı

• Karşı görüş: Blog yazılarını başkaları okusun diye yazmak, çoğu insan için yazının amacını ortadan kaldırır. Web’deki yazıların çoğu okunmaz ve okunmak için yazmak motive edici değildir

  • Yazmak, kimse okumasa bile çok değerli ve eğlencelidir. Yazı yazmak, düşüncelerini yapılandırmak ve konu ile kendin hakkında daha fazla şey öğrenmektir
  • Kişisel blogunda ilginç bulduğun konular hakkında yazmak iyi bir fikirdir. Analitik araçları kurma; yazıyı yazıp yayımladıktan sonra LinkedIn’de paylaş, bir gün birileri görüp beğenecektir

• Blog yazıları, Hacker News gönderileri ya da Reddit yazılarını eleştirel değerlendirmesi için yapay zekaya sormak etkili oldu. Yapay zekanın geri bildirimi şaşırtıcıydı ve metni sanki yazar gibi yazdığımı fark ettim

• "Gerçekten okuyacağın şeyi yaz" kuralını izlemek iyi olur. Beynimiz, ürettiğimiz şeyin harika olduğuna bizi inandırır. Kendi yazına nesnel bakmanın bir yolunu bulmak önemlidir

  • Başkalarının gerçekten okuyacağı bir şey yazmak daha zordur. Senin okuyacağın bir şeyse, başkalarının da okuma ihtimali yüksektir

• Steve Ballmer, Bill Gates gibi Microsoft hissesini çeşitlendirmedi ama bu sayede Gates’ten daha zengin oldu. Yine de tek bir şirkete tamamen yüklenmenin iyi bir fikir olup olmadığı tartışılır

  • Yazıyla başkalarına faydalı olmak önemlidir. Ama daha geniş bir kitle çekmek için içeriği çeşitlendirmek çoğu zaman içi boş ve formüle dayalı yazılar üretir
  • Hacker News belirli bir kalıptaki yazıları seviyor. Çoğu akılda kalmıyor. Yorumlardan daha çok şey öğreniyorum
  • Hâlihazırda üzerinde çalıştığım ya da ilgimi çeken konular hakkında yazıyorum. Geçmişteki kendime faydalı olabilecek şeyleri yazıyorum. Bu, okur için yazmakla aynı şey değil

• Kişisel olarak yazıya tutkuyla bağlı olmak gerekir. Aksi halde okurlar bunu fark eder ve eleştirir. Yazmak kendin için olmalı

• Blog yazıları her zaman kısa mı olmalı? Uzun yazının gerekli olduğu durumlar da var mı?

• Hacker News okurları genelde kripto para ile ilgili konulara mesafeli olsa da, bu makale ana sayfaya çıktı

• Geliştiricilerin okuyup paylaşacağı blog yazıları üretmenin iki yolu var

  • Çok sayıda yazı yazıp sonunda başarılı olanı bulmak
  • Araştırma yapıp emek vererek yazmak
  • Ben ikinci yaklaşımı yoğun biçimde kullanıyorum. Her yazıyla gurur duyabilmek için çok zaman harcıyorum. Yapıyı ayarlamaya, daha özlü hâle getirmeye ve hızlıca taranabilir olmasına çalışıyorum

• Popüler bloglar çoğu zaman burada önerilenin tersini yapıyor. Yine de kendi stilini bulmak ve popülerliği optimize etmek isteyenler için faydalı tavsiyeler