cleaning up the basic docs to make phpdoc pull useful things out