README updated, method comments updated