fix docs
improve docblocks
add method
typos
correct variable names
minor cleanup
documented methods
uppercase null