updates documentation and adds caveat