Using Comments: As previously discussed, it is good practice to use descriptive names for functions and parameters, because it makes it easier to understand what's going on in your code, both for you and anyone else who is reading it. But names by themselves can't always convey all the necessary information, and so that's where "comments" come in. A comment code block is a special code block that is ignored when RoboBlockly (or other programming software) runs the program. It is there simply to allow the programmer to annotate the code, giving the reader a better sense of what it does (or is supposed to do). It also is a helpful reminder for the programmer--what seems completely clear when you write it is often not so clear at a later date.

In RoboBlockly the comment code block is available in the "Text" tab menu. It looks like this:

It's usually not helpful to put a comment before every line of code, but it is good practice to put a comment at the beginning of major sections (so the act like headings) and before complicated lines of code.