API doc: Incorrect parameter list in Marquez API doc

[howardyoo]

Problem

The list of parameters shown in the Marquez API doc powered by openapi does not seem to be correct, as defined in https://github.com/MarquezProject/marquez/blob/main/spec/openapi.yml

  /events/lineage:
    get:
      operationId: getLineageEvents
      parameters:
        - $ref: '#/components/parameters/sortDirection'
        - $ref: '#/components/parameters/before'
        - $ref: '#/components/parameters/after'
        - $ref: '#/components/parameters/limit'
      summary: List all received OpenLineage events.
      description: Returns a list of OpenLineage events, sorted in direction of passed sort parameter. By default it is desc.
      tags:
        - Events
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LineageEventList'

Looks like the before and after parameter does not have the correct description as shown here:

marquez/spec/openapi.yml

Line 798 in b9abb19

before:

marquez/spec/openapi.yml

Line 808 in b9abb19

after:

Solution

Fix the name, type to the proper format.