add caveats, classes to readme