Visual Basic® Style Guide, The

How to Employ Style

As a segue into the topic of style, let us discuss the style of comments. Comments pro- vide a level of readability to the code in the programmer's native language. Since source code is really just an ordered arrangement of words and symbols, it is important to set your comments apart from the rest of the source code so that they can be perused quickly. One way of doing this is to place blank lines before and after all comments and the code associated with those comments. However, this gives a disjointed feeling to the code, and you are never sure if a free-floating comment is just that, or if it really remarks on the logic statements that follow it.

A better method for separating out the comments is to use some typographical ...