Add documentation of @wait_for_reactor, and other documentation improvements.
Update changelog, and bump version in preparation for eventual release.