في غالب أحاول تجنب كتابة التعليقات و ذلك بجعل الشفرة مقروءة بشكل أكبر ,و في بعض الاحيان أترك رؤوس أقلام لنقاط التي قد تكون غامضة و آخرى تحذيرات لشفرة قد تستخدم بشكل خاطئ و أيضا لقائمة المهام (TODO). أكتبها بشكل مفصل عندما أريد إنشاء توثيق لشفرة باستخدام أحد ادوات لإنشاء التوثيق ( javadoc , pydoc) بتنسيقات مختلفة مثل HTML أو غيرها