minor improvement: added doc to methods