added caveats sections to docs

changed issue tracker to github