# added documentation to public methods