การเขียนคำอธิบายโค้ดที่เราเขียนเป็นเรื่องจำเป็นมาก เพื่ออธิบาย ว่าโค้ดที่เราเขียนทำงานยังไง นอกจากนี้ ยังเป็นบันทึกช่วยจำ และ ถ้าเขียนโค้ดกันหลายคน ก็เป็นประโยชน์กับคนอื่นที่เข้ามาอ่านโค้ดของเราด้วย การเขียนคำอธิบายโค้ด หรือ comment บรรทัด ที่เรา ใส่เครื่องหมาย comment ไว้ Python จะไม่นำไปแปลความหมาย (ไม่ถูกประมวลผล)
การเขียนข้อความอธิบายในโค้ด ต้องอยู่หลังเครื่องหมาย # เท่านั้น เช่น
var_dict = {}
var_dict['one'] = "This is one"
var_dict[2] = "This is two"
print (var_dict) # แสดงค่าทั้งหมดของ var_dict
ตามตัวอย่าง การเขียนข้อความอธิบายในโค้ด คือ คำว่า " แสดงค่าทั้งหมดของ var_dict " ซึ่งอยู่หลังเครื่องหมาย ชาป(#)