Comments, method tweaks


This is a series of commits mostly focused on fleshing out the comments to make this easier to use in general. More importantly, there's been a bit of restructuring to follow the PSR-0 and PSR-1 specs.

ref: https://github.com/php-fig/fig-standards