Add documentation about the terms used in the code

This is the first step towards closing issue #7.