Fix naming and comments sections

Talk a little more about naming variables and context, and on choosing a convention.

Make the voltage comment actually a good comment.