Emphasised the synchronous assertions in docs and code

[etianen]

Although logot.wait_for() is the pun, the synchronous interface is likely the most useful to most people, and should be front-and-center in the docs.