كتبت وثيقة متطلبات طويلة ومفصلة.
حطيت فيها الخلفية، والأهداف، والسيناريوهات، وقواعد العمل، والحالات الاستثنائية، وحتى الرسائل اللي تظهر للمستخدم.
أرسلتها للفريق وأنا راضي عن نفسي.
في الاجتماع سألت:
فيه أي ملاحظات على الوثيقة؟
صار هدوء غريب.
بعدها قال أحد المطورين:
بصراحة، قريت أول كم صفحة وبعدين ضعت.
هنا عرفت أن الوثيقة قد تكون كاملة، لكنها مو بالضرورة مفيدة.
الهدف من التوثيق مو إثبات أنك غطيت كل شيء. الهدف أن الفريق يفهم المطلوب ويقدر يبني المنتج بدون تخمينات.
رجعت رتبت الوثيقة بطريقة أبسط: ملخص للمشكلة، النتيجة المطلوبة، السيناريو الأساسي، قواعد العمل، الحالات الاستثنائية، الأسئلة المفتوحة، وروابط التصاميم.
وخليت التفاصيل الإضافية في ملاحق منفصلة.
الوثيقة الجيدة مو الأقصر دائمًا، ولا الأطول دائمًا. هي اللي تعطي كل شخص المعلومة اللي يحتاجها في الوقت المناسب.
خلاصة اليوم:
إذا كانت الوثيقة شاملة لكن محد فهمها، فهي ما أدت وظيفتها.
إطلاق 