update documentation for more intuitive
update documentation for more intuitive