[*] updated readme & docblocks