Refactor: controller: best practices for handling fencing notifications

Rename tengine_stonith_notify() to handle_fence_notification(), rename its
st_event argument to event, add a doxygen block, and use some new variables and
reformatting to make it easier to follow (and change later).