İhtiyaç ve karar sınırı
Ürünü yalnızca ilk geliştiricinin bilmesi sürekliliği zayıflatır.
Bakım devri dokümantasyonu konusunda ilk iş, mevcut davranışı gözlemleyip beklenen sonucu açıkça yazmaktır. İlgili kullanıcıyı, veriyi ve işlemin tamamlandığı noktayı belirlemeden araç seçimine geçmeyin. Bu rehberdeki örnek bir uygulama senaryosudur; gerçekleşmiş bir müşteri sonucu veya performans garantisi değildir.
Uygulama yaklaşımı
Kurulum, yayın, veri modeli ve sorun giderme adımlarını çalışan örneklerle yazın.
Örnek senaryo: Yeni ekip üyesi belgeyi izleyerek test ortamını ayağa kaldırır. Bu akışı önce sınırlı veriyle çalıştırın. Girdiyi, yetkili kullanıcıyı ve beklenen çıktıyı aynı kayıtta tutun. Gereken bağımlılıkları ve hata durumunda sorumluluğun hangi ekipte olduğunu görünür hâle getirin; böylece çözüm yalnızca normal koşullara bağlı kalmaz.
Kaçınılacak hata
Güncel olmayan komutlar dokümanı güvenilmez kılar.
Bu riski kabul kriterine dönüştürün: beklenmeyen girdi, eksik izin veya kesilen işlem sırasında sistemin ne yapacağı belli olmalıdır. Sorunu gizleyen genel bir başarı mesajı yerine gerçek durumu gösterin. Düzeltmenin başka bir kullanıcı akışını bozmadığını kontrol etmek için önceki davranışı da karşılaştırmaya dahil edin.
Doğrulama ve takip
Temiz ortamda kurulum ve geri dönüş adımlarını uygulayın.
Test sonucunu yalnızca geçti veya kaldı diye kaydetmeyin. Kullanılan ortamı, örnek veriyi, gözlenen sonucu ve kalan sınırlamayı belirtin. Yayın sonrası aynı kontrolü gerçek kullanım sinyalleriyle gözden geçirin. Yeni bir araç ya da sürüm geldiğinde önce bu kabul kaydını yeniden çalıştırın; kararın gerekçesi değişmişse yaklaşımı küçük adımlarla güncelleyin.