كيف تكتب شفرة مصدرية سهل القراءة؟

اذا كنت تعاني من صعوبة قراءة وتفسير الشفرات التي تكتبها ، اقرأ هذه المقالة.

الخطوات

1- قم بإضافة التعليقات. أغلب لغات البرمجة تستخدم علامة // للإشارة للتعليقات.
2- تأكد من وجود كل دالة في سطر منفصل. على سبيل المثال ، إذا كنت من مبرمجي لغة ++C ولديك عبارتا cout ، ضع كل عبارة على سطر منفصل.
3- تفادى استخدام طريقة ASCII ، أو الاستعانة بالأيقونات أو التسميات المختصرة مثل lol, rofl. ألخ. إذا قمت باستخدام أشياء سخيفة (كالآنفة الذكر) ستكون في النهاية الخاسر الأكبر.
4- تأكد من إضافة مسافات بادئة عند استخدام العبارات الشرطية ، الدوال، أوالعبارات التكرارية مثل if else, switch case, while, do while, do while وعبارات أخرى.

ملاحظات مهمة

- هذه بعض الأمثلة التي يجب أن تتفاداها عند كتابتك الشفرة المصدرية: . l0l 1 4m $0 l33t th4t u n00bs r n0 m4tch 4 my m4d $k1llz.

- مثال لتعليق جيد : "هذه دالة cout. تقوم بطباعة نص على الشاشة."

- إن كنت لا تدري ما هو فن ASCII فهي استخدام حروف الـ ASCII مثل ------> لعمل صور.   ترجمة : زاهر النوتكي المصدر : How to Write an Easy to Read Programming Code الترخيص : Creative Commons