README changes - adding various features to feature documentation, and cleaning formattting.

Part 2 of original code cleanup PR. This is the README changes that I propose.