Skip to content

Commit

Permalink
Add language bindings in implementation guide (#92)
Browse files Browse the repository at this point in the history
* Add language bindings in implementation guide

* Replace Entur Maven Central URL with MobilityData
  • Loading branch information
richfab authored Apr 30, 2024
1 parent 463d7f8 commit e7f4c51
Show file tree
Hide file tree
Showing 2 changed files with 2 additions and 2 deletions.
2 changes: 1 addition & 1 deletion docs/en/learn/guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -175,7 +175,7 @@ The best way to ensure that the feeds you produce are valid, is to generate a da

_A data model generated from the [GBFS JSON schema](https://github.com/MobilityData/gbfs-json-schema) is the safest and most efficient way to transform your data into the GBFS structure._

You can use the [Entur](https://developer.entur.org/) open source [GBFS Java model](https://github.com/entur/gbfs-java-model), generated from the official [GBFS JSON schema](https://github.com/MobilityData/gbfs-json-schema). Or you can find generator tools for many programming languages at [json-schema.org](https://json-schema.org/implementations.html#generators-from-schemas).
To help with the migration to v3.0, we have worked with [Entur](https://developer.entur.org/) to publish GBFS types in TypeScript ([NPM package](https://www.npmjs.com/package/gbfs-typescript-types)) and Java ([Maven Central package](https://central.sonatype.com/artifact/org.mobilitydata/gbfs-java-model)). They are automatically generated from the official [GBFS JSON Schemas](https://github.com/MobilityData/gbfs-json-schema). So when the specification changes, your data model evolves with it. You can find generator tools for many programming languages at [json-schema.org](https://json-schema.org/implementations.html#generators-from-schemas).

Creating a data model manually from the [GBFS reference](https://github.com/MobilityData/gbfs/blob/master/gbfs.md) is possible but not recommended as it is error prone and more difficult to update when the GBFS specification changes.

Expand Down
2 changes: 1 addition & 1 deletion docs/fr/learn/guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -174,7 +174,7 @@ La meilleure façon de s'assurer que les flux que vous produisez sont valides es

_Un modèle de données généré à partir du [schéma JSON GBFS](https://github.com/MobilityData/gbfs-json-schema) est le moyen le plus sûr et le plus efficace de transformer vos données dans la structure GBFS._

Vous pouvez utiliser le [modèle Java GBFS](https://github.com/entur/gbfs-java-model) open source d'[Entur](https://developer.entur.org/), généré à partir du [schéma JSON GBFS](https://github.com/MobilityData/gbfs-json-schema) officiel. Vous pouvez également trouver des outils de génération pour de nombreux langages de programmation sur le site [json-schema.org](https://json-schema.org/implementations.html#generators-from-schemas).
Pour faciliter la migration vers la v3.0, nous avons travaillé avec [Entur](https://developer.entur.org/) pour publier des types GBFS en TypeScript ([package NPM](https://www.npmjs.com/package/gbfs-typescript-types)) et en Java ([package Maven Central](https://central.sonatype.com/artifact/org.mobilitydata/gbfs-java-model)). Ils sont automatiquement générés à partir des [schémas JSON GBFS] officiels (https://github.com/MobilityData/gbfs-json-schema). Ainsi, lorsque le standard change, votre modèle de données évolue en même temps. Vous pouvez trouver des outils générateurs pour de nombreux langages de programmation sur [json-schema.org](https://json-schema.org/implementations.html#generators-from-schemas).

La création manuelle d'un modèle de données à partir de la [référence GBFS](https://github.com/MobilityData/gbfs/blob/master/gbfs.md) est possible mais n'est pas recommandée car elle est sujette aux erreurs et plus difficile à mettre à jour lorsque la spécification GBFS change.

Expand Down

0 comments on commit e7f4c51

Please sign in to comment.