The Leg definition, 'agencyId' property currently lacks a description.

Task

• Add a description to the Leg definition 'agencyId' property.

We currently include Swagger UI 2.x directly in this repository. The latest version of Swagger UI, as of this writing, is 3.4 (released on 2017-10-21).

Task

• Upgrade this project to use Swagger UI 3.x
• If possible, the Swagger UI dependency should be installed from NPM, rather than including the Swagger UI sourcecode directly

Scrolling not works when going past Booking options, menu disappears and page jumps to the top of the page.

In the OpenAPI Designer UI, the 'mode' type definition seems to have some allowed values listed. However, the allowed values are not being displayed.

Task

• Determine why the allowed values are not displaying.
• If necessary, update the 'mode' definition allowed values so they display correctly

The info section currently contains some outdated information, such as the contact information. Upgrade info section to contain correct contact details, etc.

The Place definition, 'latitude' property currently lacks a description.

Task

• Add a description to the Place definition 'latitude' property

Consideration

Consider whether the latitude property should have its own definition, so it may be referenced in other definitions.

The 'newBooking' definition currently duplicates the 'bookingState' definition. Rather, the 'newBooking' should reference the existing 'bookingState' definition.

Task

• Update 'newBooking' definition to reference 'bookingState'.

Since we want to encourage outside participation in the development of this API definition, we should have clear guidelines for contributing. This is typically provided in written form via a file such as CONTRIBUTING(.md).

Task

• Add CONTRIBUTING.md file
• Include basic guidelines for contributing
  • creating new issues/feature requests
  • making changes (PR process)
  • code of conduct?

Resources

• Wrangling Web Contributions: How to Build a CONTRIBUTING.md

Hi,

terms is referencing the same object as state. I guess this is a mistake.

https://github.com/maasglobal/maas-tsp-api/blob/e226d68/specs/maas-v1.yml#L327-L328

The Place definition, 'stopCode' property currently lacks a description.

Task

• Add a description to the Place definition 'stopCode' property

When entered from left to right MM-DD-YYYY (right to left works)

The legGeometry definition currently lacks a description.

Task

• Add a description to the legGeometry type definition

The Leg definition, 'route' property currently lacks a description.

Task

• Add a description to the Leg definition 'route' property.

Consideration

Determine whether it might be better to define the 'route' as its own data type, so that it may be re-used in other type definitions.

In order to allow users to plan journies, we should recommend a trip planning standard. Currently, OTP is a widely adopted, open source trip planning standard.

• OpenTripPlaner website

The legGeometry definition, 'points' property currently lacks a description.

Task

• Add a description to the legGeometry definition 'points' property

Currently, the Customer definition lacks a description.

Task

• Add a description to the Customer definition.

OpenAPI specification checked by using spectral linter.

However due to bugs in spectral linter (see stoplightio/spectral#403) perfectly valid OpenAPI specifications might produce errors if use externally defined JSON Schema type definitions.

This issue can not be fixes until stoplightio/spectral#403 fixed.

The Place definition currently lacks a description.

Task

• Add a description to the Place type definition

The Place definition, 'stopId' property currently lacks a description.

Task

• Add a description to the Place definition 'stopId' property

Text difference IOS: "Your real name is needed for identification purposes when making bookings or issuing tickets"
Android (app version 1.5.241): also not allowing date of birth entry

The token definition is missing 'type' metadata. This may be due to ambiguity in ticket token formats, due to lack of standardization/open formats.

Task

• Determine what 'type' to use for the 'token' definition
• Update the 'token' definition with the determined 'type'

Reference(s)

See the related discussion in Finnish Transport Agency Lippu API: https://github.com/finnishtransportagency/lippu-api/issues/4

After installing the production Android app and activating the Whim Urban 30 plan for Helsinki, the user is asked to enter data into the HSL website. However, this externally hosted form provides no details about how the data is collected. It is unclear whether the Whim terms apply. I suggest adding a link above the button to the provider policy. Screenshot attached.

Our package.json currently says this project is UNLICENSED:

However, the LICENSE file in this repository says code is in MIT.

Update the package.json to match the repository license.

The Place definition, 'longitude' property currently lacks a description.

Task

• Add a description to the Place definition 'longitude' property

Consideration

Consider whether the longitude property should have its own definition, so it may be referenced in other definitions.

Most/all of the type definitions currently lack title properties.

Task

• Add title to most/all type definitions.

When trying to load the root route, I am seeing the following error in console:

Uncaught ReferenceError: SwaggerUi is not defined
    at HTMLDocument.<anonymous> ((index):45)
    at f (jquery-1.8.0.min.js:1)
    at Object.fireWith [as resolveWith] (jquery-1.8.0.min.js:1)
    at Function.ready (jquery-1.8.0.min.js:1)
    at HTMLDocument.pe (jquery-1.8.0.min.js:1)

This is strange, however, since SwaggerUI seems to load properly:

The Leg definition, 'routeShortName' property currently lacks a description.

Task

• Add a description to the Leg definition 'routeShortName' property.

Currently, the specification is written in Swagger (OpenAPI v2) format. Upgrade the specification to use OpenAPI v3 format.

The Leg definition, 'routeShortName' property currently lacks a description.

Task

• Add a description to the Leg definition 'routeShortName' property.