resolve_ref(): expand documentation