new methods add
update documentation