Remove outdated comment
Add BOSH design notes (to be removed when impl is done)
Refactor pause handling
Refactor pause handling 2
Refactor pause handling 3
Refactor event handling
Add note about missing handler