Refactor: libpacemaker: best practices when testing action for graph

Rename should_dump_action() to should_add_action_to_graph() for readablity,
add a doxygen block, and improve comments and formatting.