Improve the REAME file

Various typos has been fixed. And several points have been clarified.
Hope this is a much better version of the documentation.