title: Exposing the JSON Schema for API endpoints?
body: <p>Is there a standard to where and how to expose the schema of API endpoints?</p>
  
  <p>For example, let's say the following API endpoints are available:</p>
  
  <pre><code>api/companies/
  
  api/companies/{id}/employees/
  </code></pre>
  
  <p>Where should the schema for the company and employee resources be exposed?</p>
  
  <p><code>api/company-schema.json</code> and <code>api/employee-schema.json</code>?</p>
  
  <p><code>api/schemas/company.json</code> and <code>api/schemas/employee.json</code>?</p>