clean up on documentation
relates #18
minor tweaks
relates #18