Bu blog yazısında Terence Eden, yazılım dokümantasyonundaki yetersizlik sorununa değiniyor. Eden, birçok geliştiricinin kendi içsel önyargıları nedeniyle etkili README dosyaları yazamadığını savunuyor; yani geliştiriciler, bir komutu veya sistem mantığını kendileri anladıkları için yeni bir kullanıcının da anlayacağını varsayıyor. Eden, kullanıcılara sadece "RTFM" (Lanet olası kılavuzu oku) demek yerine, sunulan kılavuzların çoğunlukla eksik, güncelliğini yitirmiş veya düzensiz olması nedeniyle bu yaklaşımın genellikle etkisiz kaldığını ileri sürüyor. Bu sorunu çözmek için Eden, NLnet bursuyla finanse edilen ActivityBot projesinde uyguladığı bir metodolojiyi anlatıyor. Eden, gerçek kişilere saatlik 25 Euro ödeyerek, yazılımı şu şekilde yüklemeye çalışmalarını istedi:
Konular: Yazılım Geliştirme, Teknik Yazarlık ve Kullanıcı Deneyimi (UX)
SiteM’de tam özet, flashcard ve quiz →
Orijinal kaynak: shkspr.mobi
Kaynak: sitem.co — paylas.io yer imi / keşif katmanı.
Yorumlar
Yorum için giriş yap veya kaydol.
Henüz yorum yok — ilk sen yaz.