refs: document how current_ref is used