backport doc changes from pull requests #98 (Stateful)  and #100 (conributor typo)

(cherry picked from commit 50d8753bd55160c47837281c864bad9e33d30f62)