update caveats and examples