Docs folder cleanup

Added schema to routes docs, removed authentication, comparison,
compatibility files along with internals as they are now located in the
wp-api.org docs repo. We should not now remove these files from the
WP-API plugin folder to eliminate confusion.
Merge pull request #441 from pollyplummer/docs-cleanup

Docs folder cleanup