tweak docs to be more inline with standard conventions