document rationale for void return of subscribe()

fixes #43
Merge pull request #51 from rkuhn/wip-void-subscribe-rk

document rationale for void return of subscribe()
Merge branch 'refs/heads/master' into edit-doc-simplified-types
 (PR #51)