updated caveats section and fixed okes comment