9.5 Comments

You should use comments to document code as it’s written. It is important to document your code so that you, and any readers, can understand it. When you or someone else reads a comment, they should be able to easily understand the code the comment applies to and how it fits in with the rest of your code.

Some points to remember when adding comments:

• Limit the line length of comments and docstrings to 79 characters.
• Use complete sentences, starting with a capital letter.
• Make sure to update comments as your code changes (it's easier to remember what is happening)