Refactor: scheduler: best practices when freeing notification data

Rename free_notification_data() to pcmk__free_notification_data(),
make library-private, and add a doxygen block.