document public methods