added self documenting methods and a little DRYness
Add comment to method.
Merge pull request #7 from mdsol/feature/updates_per_rtomayko

added self documenting methods and a little DRYness