fix typo, add caveats