make RR methods more consistent and document them