updated tests to reflect new locations
added docsUrl per https://github.com/reverb/swagger-spec/pull/75/files
added sample, renamed to externalDocs