Adds Region Events API docs.

:trumpet:

This replaces #1859 because it's opened against minor, ~~but I haven't yet made any changes based on the discussions there.~~

– Updated per @paulovieira's comments (thanks!)
– I still need to update still per @thejameskyle's comments