نحو البرمجة ب Xcode ما تحتاجه لبرمجة الماكنتوش بلغة Objective-C — الصفحة ٢١

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

النص مستخرج آليًّا من صور الكتاب، وقد يقع فيه خطأ.