Lots'o documentation

closes #72
Adding method and class-level documentation to the utility class... much
more verbose now and more hints on what does what from the IDE and at
the code level