Document persistence failure behavior for all events

[tnull]

We addressed most of #2097 in #2995.

However, we still need to document for each event type what the expected persistence failure behavior is, especially if we fail to persist ChannelManager (see #2995 (comment)).

[TheBlueMatt]

Ugh, we should really have gotten to this...