Scripter Javascript Tutorial

78 Comments

Good comments should explain what is being accomplished in the code at a high level. There may be times when a line-by-line explanation is needed, especially if a code block needs to be revisited at some point in the future, but those kinds of comments should be rare. Good variable and function names should be able to fill in those blanks. Comments should require far less maintenance than the code itself. The following are examples of very common types of comments.