add: documentation for public methods