Single and Multi-Line Comments in Python

One of the most basic things you’ll learn in the Python language is how to write comments in Python. In programming, comments are sections of a code block that are neither read by the compiler or the interpreter. They’re purely for the programmer. You can consider comments as a type of necessary human-readable documentation.

Comments work more or less the same in every programming language. But if you’re new to programming or new to Python, you need an in-depth understanding of how comments work and how to use them. Today, we’ll look at writing comments in Python, how to add comments, how to create a multiline comment, and what types of comments you should use. 

The purpose of comments in Python

The purpose of comments in Python programs is the same as comments in any other programming language—documentation and debugging:

• Documentation. Comments tell programmers (and yourself) the intent of the code that you’re writing. When you read code later, it may not always be clear what that code is doing. 
• Debugging. Comments can help you remove parts of your code that aren’t working so you can isolate which part of it isn’t working. This makes it easier for you to debug your code.

When using comments for documentation, they should always be included. When using comments for debugging sessions, they should be more or less temporary.

Recommended Learning Platform course

The Complete Python Bootcamp From Zero to Hero in Python

Jose Portilla, Pierian Training