resolve_gitlink_ref(): improve docstring