Why Comments in Python? - Purpose & Use Cases

The Big Idea

Ever wondered how programmers remember what their code does months later? The secret is simple notes called comments!

The Scenario

Imagine you write a long recipe by hand without any notes or explanations. Later, when you try to follow it, you forget why you added certain steps or what some ingredients do.

The Problem

Without comments, your code becomes hard to understand and maintain. You might spend a lot of time guessing what each part does, leading to mistakes and frustration.

The Solution

Comments let you add simple notes inside your code. They explain your thinking, making it easier for you and others to read and fix the code later.

Before vs After

✗ Before

print('Hello World')
print('Calculate total')
total = price * quantity

✓ After

# Greet the user
print('Hello World')
# Show calculation step
print('Calculate total')
# Multiply price by quantity to get total
total = price * quantity

What It Enables

Comments make your code clear and friendly, so anyone can understand and improve it easily.

Real Life Example

When working on a group project, comments help teammates quickly grasp what your code does without asking you repeatedly.

Key Takeaways

Comments explain your code in simple words.

They save time and reduce errors when revisiting code.

Good comments make teamwork smoother and code easier to maintain.

Practice

1. What symbol is used to write a single-line comment in Python?

easy

A. /* */

B. //

C. #

D.

Solution

1. Step 1: Identify the comment symbol in Python

   Python uses the # symbol to start a single-line comment.

2. Step 2: Compare with other languages

   Other symbols like // or /* */ are used in languages like JavaScript or C, not Python.

3. Final Answer:

   # -> Option C

4. Quick Check:

   Single-line comment = # [OK]

Hint: Single-line comments start with # in Python [OK]

Common Mistakes:

• Using // instead of #
• Using /* */ for single-line comments
• Confusing HTML comments with Python

2. Which of the following is the correct way to write a multi-line comment in Python?

easy

A.

B. '''This is a multi-line comment'''

C. // This is a multi-line comment //

D. /* This is a multi-line comment */

Solution

1. Step 1: Recognize Python multi-line comment style

   Python uses triple single quotes ''' or triple double quotes """ for multi-line comments or docstrings.

2. Step 2: Eliminate other language comment styles

   Options A, B, and D are comment styles from other languages like HTML, JavaScript/C++, and C.

3. Final Answer:

   '''This is a multi-line comment''' -> Option B

4. Quick Check:

   Multi-line comment = triple quotes [OK]

Hint: Use triple quotes ''' or """ for multi-line comments [OK]

Common Mistakes:

• Using // or /* */ which are not Python syntax
• Using HTML style comments
• Trying to use # for multi-line comments without repeating

3. What will be the output of the following code?

print('Hello')  # This prints Hello
# print('World')

medium

A. Hello

B. SyntaxError

C. World

D. Hello\nWorld

Solution

1. Step 1: Understand the effect of comments on code execution

   The first line prints 'Hello' because the comment after it does not affect the print statement.

2. Step 2: Recognize that the second print is commented out

   The second print statement is fully commented out, so it does not run or print anything.

3. Final Answer:

   Hello -> Option A

4. Quick Check:

   Commented code does not run = Hello [OK]

Hint: Code after # is ignored; only uncommented lines run [OK]

Common Mistakes:

• Thinking commented print runs
• Expecting both Hello and World printed
• Confusing comment with string

4. Find the error in this code snippet:

# This is a comment
print('Start')
'''This is a comment without an end
print('End')

medium

A. Comments cannot be placed before print statements

B. No error, code runs fine

C. print('End') is outside comment and runs normally

D. Missing closing triple quotes causes SyntaxError

Solution

1. Step 1: Check triple quote usage

   The triple quotes start a multi-line comment but are not closed, causing a syntax error.

2. Step 2: Understand impact on code parsing

   Without closing quotes, Python treats the rest as part of the string, leading to a SyntaxError.

3. Final Answer:

   Missing closing triple quotes causes SyntaxError -> Option D

4. Quick Check:

   Unclosed triple quotes = SyntaxError [OK]

Hint: Always close triple quotes to avoid syntax errors [OK]

Common Mistakes:

• Ignoring missing triple quote closure
• Thinking comments can be unclosed
• Assuming code after triple quotes runs

5. You want to temporarily disable a block of code without deleting it. Which is the best way to do this in Python?

hard

A. Put # at the start of each line in the block

B. Surround the code block with triple quotes ''' ... '''

C. Use /* ... */ around the block

D. Wrap the block in

Solution

1. Step 1: Understand Python comment styles for disabling code

   Python does not officially support block comments; the common way is to put # at the start of each line.

2. Step 2: Evaluate triple quotes usage

   Triple quotes create a string literal, which may not disable code properly and can cause unexpected behavior if used improperly.

3. Step 3: Recognize other language comment styles

   Options C and D are not valid in Python.

4. Final Answer:

   Put # at the start of each line in the block -> Option A

5. Quick Check:

   Disable code block = # per line [OK]

Hint: Use # on each line to disable code safely [OK]

Common Mistakes:

• Using triple quotes which may not disable code
• Using /* */ which is invalid in Python
• Using HTML comments which do nothing in Python