and also detail how version 3 works, so that previous version 2
users who expect the `watch_login` decorator aren't confused.
Issue #272 was opened due to incorrect documentation. Unfortunately,
the relevant documentation file was deleted rather than updated,
and the issue was closed. This commit is intended to fix the missing
documentation.