İş kuralları için, @Joppe hepimizin düşündüğümüz UML'ye işaret ettiğini düşünüyorum.
Vaka Diyagramlarını Kullan, Aktörlerin / Rollerin sistemle nasıl etkileşime girdiğine ve sistemin ne yaptığına dair mükemmel bir genel bakış yapar. Complexe Use Case için ek bilgi çok yardımcı olacaktır metinsel olarak açıklanmış ( ön koşulların , Hedefşartlar , önceki UC yürütmeler üzerinde bağımlılıklar , vb )
İşletmenin farklı düzeylerde mükemmel bir şekilde gözden geçirilmesini sağlayan diyagramlar vardır:
- Belgelenecek herhangi bir durum varsa Makine Şemasını belirtin .
- Faaliyet Şeması . Karmaşık Kullanım Durumu için ayrıntıların derinliklerine gitmeniz gerekebilir. Ayrıntıların seviyesi size bağlıdır ve belgeleri kimin okuyacağına bağlıdır. Bu, iş benzeri belgeler gibi görünmeyebilir, ancak doğru düzeyde ayrıntılarla bu hale gelebilir.
Sadece bir tavsiye, her Kullanım Durumuna bir kod atayın (örn: UC-1 , UC-n ). Bunlar daha sonra kullanıcı arayüzü dokümantasyonunda faydalı olacaktır.
UI dokümantasyonu için ortak uygulama (bugünlerde) tel kafesler yapmaktır . Ekran çekimlerinden çok daha iyi çünkü daha temiz ve basit görünüyor. Örneğin, WireframeSketcher'a bir göz atın
Tel kafesler yeterli dokümantasyon olmayabilir, bu nedenle her ekran için kısa bir giriş yapın ve her düğmeyi açıklayın. Ayrıca, ekranda yer alan UC'ye referanslar yapın ( şimdi UC kodlarının neden yararlı olduğuna bakın ). Bu, belgelerinizi tutarlı hale getirecektir.
Wireframesketcher gibi araçların amacı interaktif maketler yapmalarıdır. Hala tasarlarken veya geliştirirken müşteriye etkileşimli bir şey vermek için mükemmeldir.
Navigasyon planını belgelemeyi unutmayın . Nav. Planın UML diyagramı yoktur, bunun yerine Durum Makinesi Diyagramı kullanılabilir. Yapıldığı şey için değil, yine de.
Sonunda kime hitap ettiğinizi unutmayın.
Teknisyen : Detaylara inebilir ve teknik özellikleri kullanabilirsiniz.
Teknisyen değil : tekniklerden kaçının (ne dil ne de kodla ilgili). Açık ve basit olmaya çalışın ve müşterinin kullandığı terimleri / kelimeleri kullanın. Programlama hakkında hiçbir fikriniz olmadığını düşünün.