documentation updated with caveats