مقدمة
يجب أن تنقل التعليمات البرمجية التي تكتبها هدفك إلى كل من المحول البرمجي والمطورين الآخرين الذين قد يحتاجون إلى قراءة التعليمات البرمجية الخاصة بك. وبما أنك المطور الذي سيقرأ التعليمات البرمجية الخاصة بك في معظم الأحيان، وأحيانا بعد أشهر من كتابتك لها في الأصل، فمن مصلحتك كتابة تعليمة برمجية واضحة وسهلة الفهم. تذكر أنه يمكنك كتابة التعليمات البرمجية مرة واحدة، ولكن ستحتاج إلى قراءتها عدة مرات.
لنفترض أنه تمت مطالبتك بكتابة بعض التعليمات البرمجية لمجموعة أخرى من المطورين. يمكنك الاجتماع معهم لمناقشة المواصفات والتعيين واضح. بعد الاجتماع، يخبرونك أنك ستعمل بشكل مستقل أثناء التطوير. بمجرد الانتهاء، ستقوم بتسليم التعليمات البرمجية الخاصة بك إلى المجموعة الأخرى. مهمة الترميز ليست خارج مستوى مهاراتك، ولكن لم يكن لديك أبدا لكتابة التعليمات البرمجية التي سيحافظ عليها شخص آخر. أخبرك الفريق أنه طالما تتبع اصطلاحات الترميز القياسية ل C#، فلا ينبغي أن تكون هناك مشكلة. يمكنك وضع خطط لمراجعة اصطلاحات ترميز C# التي تتعلق بالتعليمات البرمجية التي ستعمل عليها.
في هذه الوحدة، ستتعلم كيفية اختيار أسماء المتغيرات التي تصف الغرض منها وهدفها. ستتعلم كيفية إضافة تعليقات التعليمات البرمجية التي توثق المتطلبات ذات المستوى الأعلى ونهجك في التعليمات البرمجية، بالإضافة إلى إرشاد المحول البرمجي مؤقتا لتجاهل أسطر التعليمات البرمجية. وأخيرًا، ستتعلم كيف يمكن استخدام مسافات بيضاء للمساعدة في نقل العلاقة بين الخطوط الفردية للتعليمة البرمجية.
بنهاية هذه الوحدة النمطية، ستكتب التعليمة البرمجية بشكل هادف أكثر مع التركيز على قابلية القراءة، وجودة التعليمة البرمجية للاتصال بكل من المحول البرمجي والمطورين الآخرين.
هام
تتضمن هذه الوحدة أنشطة الترميز التي تتطلب Visual Studio Code. ستحتاج إلى الوصول إلى بيئة تطوير تم تثبيت Visual Studio Code وتكوينها لتطوير تطبيق C#.
الأهداف التعليمية
خلال هذه الوحدة النمطية، سوف تتمكن مما يلي:
- اختيار اسم وصفي للمتغيرات يصف الغرض منها وهدفها.
- استخدام تعليقات التعليمة البرمجية؛ لإرشاد المحول البرمجي بشكل مؤقت لتجاهل خطوط التعليمة البرمجية.
- استخدام تعليقات التعليمة البرمجية لوصف متطلبات مستوى أعلى، أو الغرض من مرور التعليمة البرمجية.
- كتابة تعليمة برمجية تستخدم بشكل فعال مسافات بيضاء لنقل علاقة خطوط التعليمة البرمجية.
المتطلبات الأساسية
- خبرة في استخدام Visual Studio Code لإنشاء تطبيقات وحدة تحكم C# وتشغيلها.
- تجربة طباعة الرسائل إلى وحدة التحكم باستخدام
Console.WriteLine(). - تجربة استخدام
ifعبارات وelse ifلإنشاء فروع التعليمات البرمجية.