docs: add documentation for how graceful reloading and reconnection works
we should definitely highlight this in `README.md`

most other frameworks don't take this seriously and also don't handle reconnection events