curriculum/challenges/english/blocks/learn-how-to-document-code-for-a-project/65e93be2cbc1da18d7602a31.md
This is a review of the entire dialogue you just studied.
Write the following words or phrases in the correct spot:
comments, clarify, comment on, describe, double slashes, and parts of.
Sophie: I'm working on this code and I think it's a good idea to add BLANK. How should I write comments in the code?
Brian: Great idea. To write comments, you simply need to use BLANK to start a comment. Then, you can BLANK what the code does so that other people can understand it, too.
Sophie: And what should I BLANK? Are there any specific things I should focus on?
Brian: You should comment on any complex or tricky BLANK your code. You can also explain what certain functions do and BLANK the purpose of variables. Try to ensure that your comments are clear and concise.
Sophie: I appreciate your help. I'll start adding comments to the code.
comments
Notes in the code that explain what it does. The computer skips them.
double slashes
Typing // starts a comment in many programming languages.
describe
To explain what something is or what it does.
comment on
To write a note or give your opinion about something.
parts of
Different sections or pieces of something.
clarify
To make something easier to understand.