Conflict in documentation regarding Trip - trip_type about mds-openapi

[schnuerle]

Looks like the Stoplight docs are in error. Should be one trip type. A PR can be created here https://github.com/openmobilityfoundation/mds-openapi

[schnuerle]

I'm not sure exactly how to change this trip_type array to an enumerated value based on mode in OpenAPI.

Maybe @mplsmitch @thekaveman could help advise.

Also might need to edit in passenger services, car share, delivery robots, and micromobility pages.

I have a fix-trip-type branch started for this work here.

[thekaveman]

The schema does allow only a single trip_type (via the minItems: 1 and maxItems: 1 qualifiers), however it seems like an error since this type should be a string and not an array.

I think the changes would be:

trip.trip_type:

trip_type:
  type: string

Then for each of the mode-specific trip definitions, raising the enum property out of the items key, e.g. for passenger-services.trip:

trip_type:
  enum:
    - private
    - shared
    - reservation
    - empty