Herhangi bir belge ile çevik yaklaşımın iyi olduğuna inanıyorum. Şimdi, çevikliğin "hiçbir belge veya analiz yok" anlamına geldiği konusunda bazı yanılgılar var, ancak durum böyle değil. Çevik hakkında okuduğum şeyler "neyin işe yaradığını kullan" der. Bunu, belgenin göreve uygun uzunlukta ve ayrıntılı olması gerektiği anlamına geliyor.
Şablonlar bir kontrol listesi olarak yardımcı olabilir, ancak küçük veya düşük riskli değişiklikler için her bölümün doldurulmasını istemem. Tek satırlık bir değişiklik için, belki de bir dokümana ihtiyacınız yoktur. Etki analizi belgesi için hiç şablon kullanmadım, ancak düzenli olarak iş gereksinimleri veya teknik özelliklerle ilgileniyorum. Bir şablon çok kısıtlayıcı olabilir; bunun yerine iyi bir rehber izleyicinin kim olacağını düşünmektir. Teknik olmayan yöneticiler içinse, değişikliğin ticari gerekçelerine odaklanın. Teknik insanlar içinse, ekipteki yeni bir kişinin kaybolmaması için biraz arka plan sağlayın ve değişikliği desteklemeleri gerekiyorsa onlara başlayacak kadar verin. Ayrıca, daha fazla sürtünmesiz ve hafif bir şey istiyorsanız, bir dokümanı hiç kullanmayın, bir wiki'ye koyun.
Eklenecek bilgiler:
- Sorunun kısa açıklaması
- Kusurun başarısızlığa ve / veya verimsizliğe nasıl neden olduğunu açıklayın veya gösterin
- Karmaşıklık tahminini dahil et
- Düzeltme için maliyet ve zaman tahminini ekleyin
Bu iyi bir minimum. Diğer yazı, IBM'den oldukça ağır CMMi öğelerini vurguladı; bunun için zamanınız ve kaynaklarınız varsa (ve insan hayatının tehlikede olduğu NASA için sistemler oluştururken, insanlar bu konuda ciddi olsa iyi olur) harika ama küçük takımlar için muhtemelen bu kadar ağır olmanıza gerek yok . Tahminlere her zaman olduğu gibi dikkat edin. Yöneticiler bir tahminin gerçek olduğunu varsayarlar.
Çevik yaklaşımda tehlikeler olduğunu unutmayın. Bazı geliştiriciler bunun "dokümana gerek yok, sadece hack yapmaya başlayın" anlamına geldiğini düşünüyor (bazı durumlarda sorun yaratabilir). Ayrıca, diğerleri görev verilen enlemi alacak ve gerçekten yardım etmeyen gerçekten berbat belgeleri yazacak (çoğu durumda mutlaka sorun değil). Sorunun bir kısmı iyi yazmanın biraz çaba, beceri ve zaman gerektirmesidir; çoğumuz bunlardan en az ikisinde kısayız;)
Her zaman dokümantasyon konusunda büyük oldum çünkü en azından bir plana sahip olmak için yeterli düşünceye sahip olduğunuzu kanıtlıyor. Ancak yaşlılığımda, çok fazla dokümantasyonun kendisinin bir bakım güçlüğü haline gelebileceğini ve dokümantasyonun güncellenmesini sağlamak için yeterli sayıda insanın yeterli olmadığını umuyorum.