Clarify the type of Localized URL

[tdelmas]

What is the issue and why is it an issue?

The type Localized String is used at a multiple places with an additional specification that text must be of the type URL. It is an issue because it makes the specification more verbose, so less readable.

Please describe some potential solutions you have considered (even if they aren’t related to GBFS).

I propose to define that Localized String where the text is a URL as Localized URL. The type in the header, so the type is more explicit.

But maybe the type Localized URL should be defined as A fully qualified URL to be even clearer?

[tdelmas]

Ping @richfab : Can I have your opinion on this change? Do you think it falls in the "Editorial changes" category?

[richfab]

Hi @tdelmas, sorry for the delay.
Could you please give more context as to what is the issue and why it's an issue please?
Are you suggesting to replace the type URL by Localized URL in the spec?
Thank you in advance!

[tdelmas]

(sorry for the late reply too!)

• What is the issue: The type Localized String is used at a multiple place with an additional specification that text must be of the type URL. It is an issue because it makes the specification more verbose, so less readable.

I propose to define that "Localized String where the text is an URL" as "Localized URL" the type in the header, so the type is more explicit.

But maybe the type "Localized URL" should be defined as "A fully qualified URL" to be even clearer?

[richfab]

Tagging recent contributors to get your opinion: @mplsmitch, @testower, @cmonagle, @simonsolnes, @ezmckinn, @AntoineAugusti, @ArashMansouri, @jkurzanski.
Thank you!

[testower]

I agree it is confusing. And made further confusing by the fact that it is not actually the URL itself that is localized (or translated), but the URL points the a version of the content that is localized according to the language code...

[AntoineAugusti]

👍 transport.data.gouv.fr, a simple and useful clarification.

[jkurzanski]

👍 for Vulog

[testower]

👍 from Entur as well

[richfab]

One minor typo to fix. LGTM otherwise!

Thank you @tdelmas for this helpful contribution 💯

[richfab]

LGTM!
Merging now 🚀