version 1.0.2
minor fixes in README
added upgrade note link for deprecations
Merge branch 'origin/1.0.2'