README changes

This version introduces multiple enhancements:

README changes

Details of additions/deletions below:
--------------------------------------------------------------

Modified:   README.md
            -- Updated --
                some documentation changes