Refactor: libcrmcommon: best practices for add_tag_ref()

Rename to pcmk__add_idref(), add a doxygen block, assert on errors instead of
returning FALSE, avoid unnecessary variables, and improve log messages,
variable names, comments, and formatting.