update readme with docs info
update docblocks
update docblocks
update comments
rename Resource to Handle, since PHPDocumentor confuses 'Resource' class name with 'resource' data type