new methods
update documentation