VP-317: updated README

Updated the summary, fixed the descriptions of the options.