Belge dışında neleri yönetiyorsunuz?
Bir belge, kararı kaydetmenin yalnızca bir yoludur. Ayrıca hangi maddelerin üzerinde anlaşmaya varıldığını, hangilerinin hâlâ öneri olduğunu, soruları kimin yanıtlayacağını ve bir madde değiştirildiğinde nelerin değişeceğini bilmeniz gerekir. Bu, aynı isteğin farklı yorumlarına göre geliştirme yapılmasını önlemeye yardımcı olur.
Aynı yaklaşım uygulama geliştirmede, kurum içi araçlarda, ürün koşullarında ve işletim kurallarında da yardımcı olabilir. Her şeyi bir anda belgelemeye çalışmak yerine tek bir özellik veya iş akışıyla başlayın.
Hedefi, gereksinimi, şartnameyi ve kabul kriterlerini birbirine bağlayın
Ekipler bu terimleri farklı şekillerde kullanır. Bu örnekte gereksinim, ihtiyaç duyulan bir sonucu veya kısıtlamayı tanımlar; teknik özellik, üzerinde anlaşılan davranışı kaydeder; kabul kriterleri ise bunun nasıl kontrol edileceğini açıklar. Birlikte çalıştığınız kişilerle bu anlamlar üzerinde anlaşın.
Hedef: elle yazıya aktarmayı azaltmak
Aylık raporlama sürecinde şu anda kayıtlar elle kopyalanıyor. Dışa aktarmanın amacı bu işi kolaylaştırmaktır.
Gereksinim: rapor için gereken kayıtları dışa aktarma
Bir personelin, erişim yetkisi kapsamındaki kayıtları seçilen ay için dışa aktarması gerekiyor.
Şartname: dosyayı ve davranışını tanımlayın
Sütunlar, sıralama, metin kodlaması, tarih biçimi, boş sonuçların nasıl ele alınacağı ve hatalar konusunda anlaşın. Bunlar evrensel varsayılanlar değil, bu örnek için yapılmış seçimlerdir.
Kabul kriterleri: sonucu doğrulanabilir kılın
Tarihleri ve izinleri bilinen kayıtları hazırlayın, dışa aktarma işlemini gerçekleştirin ve çıktıyı üzerinde anlaşılan sonuçla karşılaştırın.
Her öğeye doğrulanabilir tek bir fikir yazın
“Dışa aktarmayı kolaylaştırın” gibi bir ifade önemli seçimleri belirsiz bırakır. Bu öğeler bağımsız olarak değiştirilebiliyor veya doğrulanabiliyorsa dönem seçimini, dışa aktarılacak alanların seçimini, eşleşme bulunmaması durumunu ve erişim kontrolünü ayrı ele alın.
“Hızlı” veya “kolay” gibi sözcükler yerine somut koşullar kullanın. Yanıt süresi hedefi önemliyse sayının yanı sıra iş yükünü, ortamı ve ölçüm yöntemini de kaydedin. Henüz kararlaştırılmamış değerleri açıkça kararlaştırılmamış olarak işaretleyin.
Önce: “CSV dışa aktarımına izin ver.”
Sonra: “Seçilen ayı, üzerinde anlaşılan sütunları ve sıralama düzenini kullanarak dışa aktarın. Boş sonuçları ve erişim denetimlerini ayrı maddelerde tanımlayın.”
Gözden geçirilen ifade, üzerinde anlaşılması gereken seçimleri belirginleştirir ve işin atanmasını ve incelenmesini kolaylaştırır. Uygulamadan önce yine de somut alan tanımları gerekir.
Başlangıç için az sayıda alan
ID, başlık ve açıklama
Her öğeye REQ-001 gibi kalıcı bir ID verin. Konuyu, koşulu ve beklenen sonucu belirtin. Kalıcı bir ID, başlık değişse bile insanların öğeye başvurmasını sağlar.
Neden ve kaynak
Öğenin ele aldığı sorunu ve konuşma, talep veya destekleyici belge gibi hangi kaynaktan geldiğini kaydedin.
Öncelik ve kapsam
Bu sürüm için gerekenlerle bekleyebilecek işleri ayırın. Öncelik gerekçesini açıklayın; her öğeyi en yüksek önceliğe koymayın.
Sorumlu ve karar durumu
Öğeyi kimin açıklığa kavuşturacağını ve taslak, incelemede veya üzerinde anlaşılmış durumda olup olmadığını kaydedin. Uygulamadan sorumlu kişi ile onaylayan kişi farklı olabilir.
Kabul kriterleri ve ilgili bilgiler
Öğeyi ilgili teknik özelliklere, tasarımlara, görevlere ve doğrulama kayıtlarına bağlayın. Gereksinim değiştiğinde bu bağlantıları güncel tutun.
Örnek: aylık CSV dışa aktarımı için üç gereksinim
Aşağıdaki örnek açıklama amaçlıdır. Alan adları ve davranışlar, geliştirdiğiniz ürün için kararlaştırılmalıdır; bu örnek her dışa aktarma özelliği için eksiksiz bir teknik şartname değildir.
REQ-001: seçilen aya ait kayıtlar
Örnek şartname: kararlaştırılan iş saat diliminde seçilen ayı kullanın ve ID, kayıt tarihi ve başlığı UTF-8 biçiminde, önce tarihe sonra ID'ye göre sıralayarak dışa aktarın. Kabul örneği: eşleşen üç kayıt, bir başlık satırı ve yalnızca bu üç veri satırını oluşturur; diğer aylardan kayıt içermez.
REQ-002: eşleşen kayıt yok
Örnek şartname: eşleşen kayıt olmasa bile üzerinde anlaşılan başlık satırını dışa aktarın. Kabul örneği: boş test verisi, bu başlığı içeren ancak veri satırı olmayan bir dosya oluşturur. Dosya yerine mesaj tercih ediyorsanız bu farklı davranış üzerinde anlaşın ve bunu belgeleyin.
REQ-003: dışa aktarmadan önce erişim kontrol edilir
Örnek şartname: dışa aktarma izni olmayan kullanıcılar dosyayı oluşturamaz ve izin verilen kapsam dışındaki kayıtlar dahil edilmez. Kabul örnekleri, dışa aktarma izni olmayan bir kullanıcıyı ve erişebildiği kayıtlar sınırlı olan bir kullanıcıyı kapsamalıdır.
Tek tek kararları kaybetmeden hiyerarşiden yararlanın
Öğeleri amaca veya özelliğe göre gruplandırın ve ayrıntılı koşulları ilgili grubun altına yerleştirin. Örneğin: Raporlama → Aylık CSV dışa aktarımı → Hedef kayıtlar / Dosya biçimi / Boş sonuçlar / Erişim. Arka plan bilgilerini ve açık soruları tek bir uzun gereksinime karıştırmak yerine notlara ekleyin.
Bir koşul birden fazla özelliği etkiliyorsa her bölüme farklı sürümler kopyalamak yerine üzerinde anlaşılmış sürüme açık bir başvuru tutun. Değiştirmeden önce hangi sonraki şartnamelerin ve doğrulama maddelerinin buna bağlı olduğunu kontrol edin.
Mutabakatı, uygulamayı ve doğrulamayı ayrı tutun
“Mutabık kalındı”, içeriğin amaçlanan kapsam için kabul edildiği anlamına gelir. Özelliğin uygulandığı anlamına gelmez. “Uygulandı”, üzerinde anlaşılan kabul kriterlerinin karşılandığını veya özelliğin yayımlandığını kanıtlamaz. Basit bir durum listesi kullansanız bile bu ayrımları görünür tutun.
Normal durumu, boş veya eksik girdileri, izinleri ve ilgili olduğunda harici hataları gözden geçirin. Hangi kanıtların saklanacağına, bunları kimin kontrol edeceğine ve çözülmemiş bir soruyu kimin kapatabileceğine karar verin.
Bir değişikliği kabul edilmiş saymadan önce değişikliği ve etkisini kaydedin
Yeni bir istek, sorumlu kişiler nasıl ele alınacağı konusunda anlaşana kadar bir öneridir. Değişikliğin nedenini, etkilenen kimlikleri ve iş, tarihler, teknik özellikler ve doğrulama üzerindeki etkisini kaydedin. Değişikliğin özelliği zaten kullanan kayıtlara veya kullanıcılara uygulanıp uygulanmadığını da değerlendirin.
Karardan sonra mevcut şartnameyi güncelleyin ve etkilenen kişileri bilgilendirin. Nelerin değiştiğini açıklamanız gerektiğinde daha önce üzerinde anlaşılmış sürümü veya bir değişiklik notunu saklayın. Bir aracın her onayı ve revizyonu otomatik olarak kaydettiğini varsaymayın.
Güncel tutabileceğiniz bir yer seçin
Küçük bir liste için paylaşılan bir belge veya elektronik tablo yeterli olabilir. Tartışma, uygulama ve doğrulama birden fazla araca dağıldığında ana referans kaynağını seçin ve ilgili materyalleri oradan bağlayın. Önemli olan, herkesin üzerinde şu anda uzlaşılmış içeriği belirleyebilmesidir.
Taslak için AI kullanın, ardından kararları doğrulayın
AI, olası gereksinimleri listelemeye, taslağı düzenlemeye ve eksik sorular önermeye yardımcı olabilir. İstemde doğrulanmış bilgileri varsayımlardan ayırın ve henüz kararlaştırılmamış değerleri soru olarak bırakmasını isteyin. Sonucu, amaçlanan kullanımı bilen kişilerle gözden geçirin.
ReqSpec AI içinde gereksinimleri ve teknik özellikleri hiyerarşik olarak düzenleyebilir ve oluşturma, düzenleme ve kontrol işlemlerinde AI desteğinden yararlanabilirsiniz. “Boş sonuç durumlarıyla ilgili hangi koşullar hâlâ tanımlanmadı?” gibi belirli bir soru sorun. Yanıtı, kayıtlı içerikle karşılaştırarak doğrulanması gereken bir öneri olarak değerlendirin; onay veya eksiksizlik kanıtı olarak görmeyin.
Bir özellik ve bir incelemeyle başlayın
Bir özellik seçin, gerekli sonuçları listeleyin, maddelere kimlikler verin ve kabul kriterleriyle açık soruları ekleyin. İlgili biriyle bir kez gözden geçirin, ardından kararları ve sıradaki sorumlu kişiyi kaydedin. Güncel tutulan küçük bir koleksiyon, kimsenin güncellemediği büyük bir belgeden daha kullanışlıdır.
ReqSpec AI ile gereksinimleri ve şartnameleri düzenleyin
ReqSpec AI, gereksinimleri ve teknik özellikleri mobilde ve web'de düzenlemenin kolay bir yolunu sunar. Özelliklerini uygulama sayfasında keşfedin.