reorganize README
udpate README
update config
update docblocks