readme rewrite and version bump
Merge branch 'release/1.3.1' into develop