inline documentation and common update

Signed-off-by: Christopher Ross <cross@thisismyurl.com>