VDVde / OJP

Open API for distributed journey planning. CEN/TS 17118:2017.
https://www.vdv.de/open-journey-planner.aspx
22 stars 12 forks source link

Documentation malformed NumberOfResults / BaseTripPolicy #165

Closed skinkie closed 3 years ago

skinkie commented 3 years ago

image

jmaerki commented 3 years ago

Thanks, should be fixed now.

schlpbch commented 3 years ago

image

This suggests that PointOfInterestRef is of type PointOfInterestRef which would be an infinite loop.

jmaerki commented 3 years ago

Yes, that's a consequence of the documentation rules where I remove the "Structure" Suffix. How would you expect this to be resolved? I can't just remove the "Ref" at the end because that would create another conflict between "PointOfInterestRef", "PointOfInterestRefStructure" and "PointOfInterest". Same for "TopographicPlace*". The only way out is to remove the rule that removes the "Structure" Suffix.

sgrossberndt commented 3 years ago

In order not to bloat the table we will keep the removal of the "Type" and "Structure" suffix. It is documented as well in the word file:

In order to save space, data types have been truncated. So endings like “Structure” and “Type” are not written out. Instead of “InternationalTextStructure” the data type will be indicated as “InternationalText”.

trurlurl commented 2 years ago

Removed documentation label as the documentation-related work has been done.