developen

Test aktivitelerinin ne şekilde dokümante edilmeli? Yada test aktiviteleri gerçekten dokümante edilmesi gereken aktiviteler midir? Bu soruları çok sık duymakla beraber, bunlar ayrıca meslektaşlarımızın da uzun süredir tartıştiğı sorular.

Ben kendimi dokümantasyon konusunda gayet orta yolcu biri olarak düşünürüm. Faydalarına inanır ama imkansızlıkları da kabullenirim. Bu sebeple kendi yaklaşımımı burada kabaca masaya yatırmak istedim –ki tekrar bu soruyu duyduğumda, soruyu sorana gönderebileceğim bir permalink’im olsun.

Dokümantasyonun fonksiyonel katkilari tabii ki yadsınamaz. Bu sebeple mümkün olan her durumda test aktivitelerinin dokümante edilmesi gerektiğini düşünüyorum.

Özellikle hetorojen bilgi ve deneyime sahip bireylerden oluşan bir ekip ile çalismak durumundaysanız, dokümantasyon, ekibin tümünün büyük resmi görerek aynı hedefe daha net biçimde ilerlemesine yardımcı olacaktır. Ayni şekilde geliştirme ekibinin tümünün de aynı kalite bilincine sahip olması için dokümantasyon iyi bir araçtir.

Diger taraftan dokümante edilmis bir test planı, yazılım yasam döngüsü süresince, test ekipleri gibi yoldan çıkmaya müsait ekipleri dogru yolda tutabilir. Öngörülen riskler ve başlangıçtaki hedeflerimizi birinin gözümüze sokuyor olması, gereksiz test aktivitelerinin engellenmesi için “olmazsa olmaz” dır.

Lakin mükemmel bir kılıç ustası da, savas alaninda arkadan bıçaklanabilir. Bazi durumlarda dokümantasyon için yeterli kaynağımız olmayabilir. Yada keşif yöntemi ile test yapmamız gereken durumlar olabilir.

Testlerinizi hangi sebeplerle dokümante etmeniz gerektigini düşünün. Bazen tüm test setleriniz içerisinde belirli bir aktivitenin dokümante edilmesi hiçbir ihtiyaca cevap vermiyor olabilir. Bu gibi durumlarda dokümantasyondan koşarak kaçın.

Örnegin, kronik bir thread safety sorunu ile ilgili geliştirici ekip yardımınızı istedi. Bu aktiviteyi tekrarlayacağınız şüphelidir. Eger iç güdülerim beni yanıltmıyorsa, böyle bir talep size ulaştığına göre tüm ekip bu sorundan muzdariptir ve size sorun ile ilgili detayli bilgi verebilecek herkes meşguldür. Yani detayli planlama yapma şansınız olmayabilir.

Böyle bir durumda thread safe kodlama konusuna vakıf bir test mühendisinin keşif temelli test yürütmesi ve formal dokümantasyon çalışmalarınıza aykırı da olsa, çalışmanın sonunda aktivite notları yayımlaması bence en dogru yaklaşım olacaktır.

Dokümantasyonun gerekliliğini belirleyen bizim amaçlarımız ve ihtiyaçlarımızdır. Kimi zaman en doğru yaklaşım olan dokümantasyon, bazi durumlarda –üzülerek söylüyorum – vakit kaybından öte degildir.

Benim dokümantasyon amaçlarım ile ilgili minik bir listeyi de suraya sıkıştırayım.

• Kalite hedeflerini netleştirmek
• Test aktivitelerinin ve metriklerin tarih kütüğünü oluşturmak
• Test aktivitelerinin evrimini sağlamak
• Test ortamı ile ilgili kaynakların koordine edilmesi
• Ekip içinden yada dışından denetlenebilirliği sağlaması
• Testlerin kapsamını takip edebilmek
• “Simdi hangi testleri işletmeliyim?” sorusuna yanıt vererek, risk tabanlı test işletilmesine imkan tanımak
• Kendini tekrar etmekten yada gereksiz testlerden kaçınabilmek
• Gerektiği durumlarda dışarıdan test mühendislerinin, aktivitelere katılmalarına imkan tanımak
• Müşteri talebi