edits to the vignette, including Kot's
Merge branch 'master' of https://github.com/seananderson/ss3sim