openapi: 3.0.3
info:
  title: Shoehorn Documentation API
  description: |
    Per-service documentation discovered from repositories.
  version: 1.0.0

servers:
  - url: https://shoehorn.example.com/api/v1
    description: Production

paths:
  /docs:
    get:
      summary: List documentation entries
      tags: [Documentation]
      responses:
        '200':
          description: Documentation entries discovered from repositories

  /docs/{id}:
    get:
      summary: Get documentation content
      tags: [Documentation]
      parameters:
        - name: id
          in: path
          required: true
          schema: { type: string }
      responses:
        '200':
          description: Documentation content
