polished resource class doc comments