Refactor: scheduler: best practices when creating notify actions

Rename pe_notify() to new_notify_action() for clarity, add a doxygen block,
and improve variable names, comments, log messages, and formatting.