git-svn: update documentation with CAVEATS section