refs: improve comments about "reading" argument of "resolve_ref"