a bit of refactoring and commenting to clarify
Merge pull request #14 from artfoundry/refactoring-commenting

a bit of refactoring and commenting to clarify