لا تهمل التعليقات !! نحو البرمجة بـ Xcode
لا تهمل التعليقات !!
نستطيع باستخدام أسماء ذات دلالة للمتغيرات ان نجعل من الشفرة البرمجية نصوصاً قابلة للقراءة والتفسير المنطقي [1] .
[1]
float pictureWidth, pictureHeight,
pictureSurfaceArea;
pictureWidth = 8.0;
pictureHeight = 4.5;
pictureSurfaceArea
pictureHeight;
=
pictureWidth *
وبالرغم من اننا ملتزمين بعرض امثلة بعدد محدود من الاسطر، الا ان البرامج الكاملة التى تؤدي أعمال ذات قيمة غالباً ما تكون شفرتها البرمجية الموصفة اطول من ذلك بكثير.
ان توصيف وتوثيق شفرة البرنامج عملية بالغة الأهمية، فهي تمثل الهم الاكبر من مجرد الحرص على ان البرنامج يعمل بالشكل صحيح . فبعد فترة من الزمن قد ترغب بتغيير جزئية من الشفرة، عندها ستجد ان هذه التعليقات والملاحظات تلعب دوراً مهما لتوثيق واستيعاب مهمة هذا الجزء من الشفرة، ولماذا اوجدت - الشفرة بالمقام الاول .
ص ٢١