להערות (ה-comments) שאנו מוסיפים לקוד חשיבות גדולה מאד. קיימים סוגים שונים של הערות (comments) וכל סוג משמש לצרכים אחרים. 

הערות (comments) אשר מתפרשים על פני שורה אחת

כדי ליצור הערה אשר מתפרשת על פני שורה בודדת יש להוסיף לתחילת השורה את הסימן #. כאשר נעשה זאת, תהיה התעלמות מכל הקוד אשר יופיע אחרי הסימן #. אנחנו בדרך כלל נשתמש ב-comments אשר מתפרשים על פני שורה אחת כדי להסביר מה עושות שורות הקוד שמופיעות מייד אחר כך. 

הערות (comments) אשר מתפרשים על פני מספר שורות

כדי ליצור הערה (comment) אשר מתפרשת על פני מספר שורות יש להוסיף שלושה גרשיים ״״״ לפני ואחרי אותן שורות שאנו רוצים שייחשבו ל-comments.  אנו בדרך כלל נשתמש בסוג זה של הערות (comments) כדי לגרום לכך שתהיה התעלמות מקטע הקוד אשר מתפרש על פני מספר שורות. לעיתים, בתהליך הפיתוח של התכנית נרצה למחוק קטע קוד שמתפרס על פני מספר שורות. במקום למחוק אותו כדאי בדרך כלל לסמן אותו כ-comment כך שתמיד ניתן יהיה לבטל את סימני ה-commment. 

למרות שתמיד נשאף לכתוב קוד ברור (נשתדל לבחור בשמות ברורים גם למשתנים וגם לפונקציות, ונשתדל לבחור שמות שמסבירים מה הקוד עושה) השימוש ב-comments עדיין מסייע להבין את הקוד טוב יותר.

Update cookies preferences