انتقل إلى المحتوى
رجوع

قبل طلب الكود، صِف الوظيفة

يمكن لوكيل البرمجة إنتاج مقترح بسرعة. لكن السؤال يبقى: مقترح لماذا، ولمن، ووفق أي قواعد؟

أعددت لفوج IMIKNDEV موردًا حول التطوير انطلاقًا من المواصفات. يبدأ العمل قبل توليد الكود.

تقديم سياق واضح

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

وصف سلوك يمكن ملاحظته

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

مثال تعليمي: في تتبع الغياب، نحدّد من يحق له تسجيل الغياب، والحصة المرتبطة به، وكيف يظهر التصحيح. يوضّح المثال المنهج؛ ولا يوثّق قواعد تطبيقنا الداخلي.

التحضير للمراجعة

توفّر معايير القبول أساسًا للتحقق من النتيجة. وتتيح مناقشة سلوك متوقّع، أو حالة منسية، أو قاعدة فُهمت بشكل غير صحيح.

المواصفات الجيدة لا تضمن نتيجة جيدة. لكنها تجعل الطلب أوضح والمراجعة أكثر تحديدًا.

مورد الورشة متاح على GitHub. وهو يدعم التعلّم؛ وتظل الاختيارات والتحقق بحاجة إلى تفسير.


مشاركة الملاحظة:

الملاحظة التالية
في التكوين، الكود الذي يعمل لا يكفي