// employee number i gets (employee number i) + salary
employees[i] = employees[i] + salary

1. אין בעיה - סבבה של תיעוד
2. שורת ההערה יותר ארוכה מהקוד עצמו!
3. השורה לא תורמת כלום - סתם חוזרת מילה במילה על מה שהקוד עושה
4. השורה לא מפורטת מספיק. צריך להסביר איפה בונים את המערך, מקצים אותו ומשחררים אותו

מה הבעיה בקטע הבא:

int ic;      // Icon to put on the form

1. שם המשתנה לא מסביר מה ייעודו
2. התיעוד מצומצם מידי
3. התיעוד מיותר - לא מוסיף מידע
4. שם המשתנה צריך להתחיל באות גדולה