changed README format to ReStructured Text
updated README
bumped version number
add Documentation section to README
Merge branch 'release/3.1.1' into develop