Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Publication d'un JDD "données expérimentales de l'accessibilité des cheminements piétons" en format NeTEx profil France #4275

Open
Brewennn opened this issue Oct 25, 2024 · 25 comments
Assignees

Comments

@Brewennn
Copy link

A la suite des échanges relatifs à la collecte des jeux des données sur l’accessibilité piétons avec AccesLibre Mobilité, plusieurs acteurs nous ont sollicité pour publier les premières données en format NeTEx - Profil France Accessibilité à titre expérimental afin de mettre à disposition des exemple de JDD [perso, je suis d'accord pour leur publication]

Des personnes de La Rochelle et Dieppe souhaitent mettre leurs données à disposition sans pour autant les officialiser au nom de leur organisation et ces données ne doivent pas être intégrées par un calculateur.

Pour publier leurs données une première solution à envisager serait de publier un JDD par le PAN et de rajouter les données en ressources. On indiquerait dans le titre et la description que ces données sont bien expérimentales et sont publiées à titre de premier exemples. Ces données pourraient être publiées dans une rubrique à part "autres données" ?

Une seconde solution serait que ces personnes publient en leur nom sur data.gouv.fr et que nous récupérons les liens URL pour les référencer dans une rubrique à part "autres données" ? [je suis moins fan de cette solution]

@Brewennn
Copy link
Author

@thbar je te notifie car on a échangé rapidement sur ce sujet.

@Brewennn
Copy link
Author

Cet issue est liée également avec celle ci #3806, sauf qu'ici les acteurs ne souhaitent pas associer la publication avec leur organisation

@ptitfred
Copy link
Contributor

Cela n'est-il pas périlleux que de publier des données dont on ne veut pas qu'elles soient réutilisées ?

@Brewennn
Copy link
Author

Pour ne pas être réutilisé pour du calcul d'itinéraire mais plutôt pour faire des tests et diffuser le NeTEx en mode beta. Finalement on a déjà des jeux comme ça dans les rubriques "lieux de mobilité" et "Autres informations". ça serai l'occasion de clarifier l'usage de ces rubriques

@thbar
Copy link
Contributor

thbar commented Oct 28, 2024

Quelques notes en vrac suite au point d'équipe:

  • si on publie en tant que PAN, avoir un gros bandeau bien explicite en haut des jeux
  • obtenir l'accord écrit de l'AOM avant toute publication
  • gérer ça via un tag
  • exclure les jeux ayant ce tag de l'API pour éviter tout souci de consommation où le réutilisateur ne serait pas conscient des limites (ne pas envoyer quelqu'un sur un trajet d'accessibilité complètement erroné, par exemple)
  • privilégier NeTEx accessibilité et tarifs, éviter d'utiliser cela pour des formats exotiques (pente glissante / fragmentation)

@Brewennn
Copy link
Author

Dans ce cas :

  • publier un jeu expérimental du PAN et ajouter les ressources au fur et à mesure. Ce jeu aura le tag 'masqué' pour qu'il n'apparaisse pas dans l'API et sera publié dans la rubrique 'Autres informations'. Le titre du jeu de données et la description sera détaillé ci-après.
  • ajouter un bandeau sur ce jeu de données avec un tag 'experimental'. Le contenu du bandeau sera détaillé ci-après.

optionnel : prévoir une rubrique 'jeux expérimentaux' ?

@thbar
Copy link
Contributor

thbar commented Oct 29, 2024

publier un jeu expérimental du PAN et ajouter les ressources au fur et à mesure. Ce jeu aura le tag 'masqué' pour qu'il n'apparaisse pas dans l'API et sera publié dans la rubrique 'Autres informations'. Le titre du jeu de données et la description sera détaillé ci-après.

@Brewennn je pensais plutôt avoir N jeux expérimentaux (avec chacun sa description, qui apparaît dans le listing du PAN séparément) qu'un seul jeu avec N ressources (de différences provenances), pour des questions de clarté. Et techniquement faire ça rendra facile le fait de faire une "rubrique jeux expérimentaux" justement. Est-ce que ça te va dans ce sens ?

@Brewennn
Copy link
Author

ça me va

@thbar
Copy link
Contributor

thbar commented Oct 29, 2024

Ok, donc je propose en terme d'implémentation à partir de là :

  • Qu'on définisse le tag à mettre à la main (ex: expérimental ? je verrai si l'accent ne pose pas de problème)
  • Une première PR pour éliminer de l'API (= pas dans le listing /api/datasets, mais pas non plus obtenante via /api/datasets/:id, ça doit donner un 404) les jeux tags à la main (avant qu'on en ajoute)
  • Une seconde PR qui va créer un bandeau (bien coloré, tout en haut, avec un texte qui va bien, pointant idéalement vers une doc du PAN ?)
  • À ce stade on pourra référencer les jeux (avec validation AOM impérative et texte d'accompagnement ?)
  • Quand on aura 2 jeux référencés, on peut envisager la rubrique

Est-ce que j'oublie quelque chose à ton avis ?

@Brewennn
Copy link
Author

Brewennn commented Oct 29, 2024

  • les accents sont autorisés mais je ne suis pas très fan (on m'a toujours dit d'éviter en codage).
  • la première PR n'est pas utile puisqu'il y a déjà un tag 'masqué' dans le Back office qui permet de cacher les JDD de l'API ?
  • ok pour la seconde PR.
  • Autorisation de l'AOM et bien indiquer qu'on utilise la licence ouverte ?
  • ok

je pense qu'on a tout

@thbar
Copy link
Contributor

thbar commented Oct 29, 2024

+1 pour les accents :-)

Première PR -> je vais aller vérifier ce point pour être sûr, je te confirme ça !

Et sinon on est bon !

@Brewennn
Copy link
Author

Voici ma proposition d'éditorialisation pour la publication des jeux de données. Je reprécise que les données ne sont pas à réutiliser pour de l'information voyageur en bas du texte en plus du bandeau qui sera en haut : mieux vaut avertir l’utilisateur deux fois qu'une !

Titre JDD :
Cheminements piétons [ville/EPCI X] – Données expérimentales

Description JDD :

Ce jeu de données expérimental décrit le cheminement piétons autour d’un ou plusieurs points d’arrêts prioritaires et intègre l’information sur leur accessibilité.

Le jeu de données est produit notamment à partir de l’outil de collecte AccesLibre Mobilité et est publié au format d’échange NeTEx, profil français pour l’accessibilité conformément à l’arrêté du 28 mai 2024.

Le Point d’Accès National met à disposition ce jeux de données expérimental à titre d’illustration en accord avec les agents de la collectivité. Les données sont en cours de collecte et seront publiées officiellement par la collectivité dans un second temps.

Nous vous remercions de ne pas réutiliser ce jeu à des fins d’information voyageur.

@ptitfred
Copy link
Contributor

Qu'on définisse le tag à mettre à la main (ex: expérimental ? je verrai si l'accent ne pose pas de problème)

Pas d'accents dans les tags de dataset actuellement si ça peut aider.

@Brewennn
Copy link
Author

Pour le bandeau et la tag, je tente du code à ajouter :

Tag

  1. apps/transport/lib/transport_web/live/backoffice/custom_tags_live.ex : ligne 75

},
%{
name: "experimental",
doc: "Ajoute sur la page du JDD une bannière indiquant que le jeu est expérimental"
}

  1. apps/transport/lib/transport_web/templates/dataset/_banner.html.heex

ℹ️ <%= dgettext( "page-dataset-details", "This unofficial dataset is provided experimentally. Do not use it for travel information purpose." ) %>

-> on peut changer la couleur et le logo "i" pour mettre quelque chose plus de avertissant ?

Bandeau

  1. apps/transport/priv/gettext/en/LC_MESSAGES/page-dataset-details.po

#, elixir-autogen, elixir-format
msgid "This unofficial dataset is provided experimentally. Do not use it for travel information purpose"
msgstr "Ce jeu de données non officiel est publié à titre expérimental. Veuillez à ne pas le réutiliser à des fins d'information voyageur."

  1. apps/transport/priv/gettext/en/LC_MESSAGES/page-dataset-details.po

#, elixir-autogen, elixir-format
msgid "This unofficial dataset is provided experimentally. Do not use it for travel information purpose"
msgstr ""

  1. apps/transport/priv/gettext/page-dataset-details.pot

#, elixir-autogen, elixir-format
msgid "This unofficial dataset is provided experimentally. Do not use it for travel information purpose"
msgstr ""

@Brewennn
Copy link
Author

Qu'on définisse le tag à mettre à la main (ex: expérimental ? je verrai si l'accent ne pose pas de problème)

Pas d'accents dans les tags de dataset actuellement si ça peut aider.

Dans apps/transport/lib/transport_web/live/backoffice/custom_tags_live.ex ligne 53 on a le tag licence-mobilités

@ptitfred
Copy link
Contributor

Pour le bandeau et la tag, je tente du code à ajouter :

J'ai pas bien suivi : tu t'occupes des changements ?

@Brewennn
Copy link
Author

Effectivement je n'ai pas été clair. Non, je ne tente pas de Pull request j'ai juste mis mes propositions ici dans l'issue. Mais je peux proposer de changements si c'est ok pour vous. Par contre je ne saurai pas faire de propositions dans les codes "test" je ne sais pas comment ça fonctionne.

@ptitfred
Copy link
Contributor

En effet, tu auras quelques difficultés à satisfaire tous les contrôles (tests et style du code notamment)

@ptitfred ptitfred self-assigned this Oct 29, 2024
@ptitfred
Copy link
Contributor

Merci pour les textes déjà :)

ptitfred added a commit that referenced this issue Oct 29, 2024
ptitfred added a commit that referenced this issue Oct 30, 2024
github-merge-queue bot pushed a commit that referenced this issue Oct 30, 2024
* API datasets: exclure les datasets experimentaux

See #4275.

* Datasets: label experimental

Fixes #4275.

* Emoji avertissement et affichage en priorité.

* Test de l'affichage de la banière "expérimental"
@thbar
Copy link
Contributor

thbar commented Oct 31, 2024

Merci @ptitfred pour l'implém !

@Brewennn
Copy link
Author

Brewennn commented Nov 4, 2024

C'est ok pour la description et le titre des JDD @thbar ? Si oui, je publie demain les première données si c'est ok.

@thbar
Copy link
Contributor

thbar commented Nov 4, 2024

@Brewennn le titre me paraît nickel.

Je propose d'être plus incisif sur le "disclaimer" de la description, par contre:

Nous vous remercions de ne pas réutiliser ce jeu à des fins d’information voyageur.

Remplacé par

⚠️ Ne pas utiliser ce jeu de données à des fins d'information voyageur. Données non validées pour un usage en production

Et je mettrai ça plus haut dans la description pour que ça sois inratable (ou plus dur à rater), juste en dessous de :

Ce jeu de données expérimental décrit le cheminement piétons autour d’un ou plusieurs points d’arrêts prioritaires et intègre l’information sur leur accessibilité.

@Brewennn
Copy link
Author

Brewennn commented Nov 5, 2024

@thbar ok pour moi. Je l'avais mis en bas car il y a en plus le bandeau en haut mais ok pour le remonter.

Pour le warning, je propose cette phrase pour être plus clair à mon sens :

⚠️ Données non validées officiellement : ne pas utiliser ce jeu de données à des fins d'information voyageur.

@thbar
Copy link
Contributor

thbar commented Nov 7, 2024

@Brewennn parfait !

@Brewennn
Copy link
Author

@thbar voici le rendu final pour le JDD https://transport.data.gouv.fr/datasets/cheminements-pietons-ville-test-donnees-experimentales (j'ai mis en statut privé sur data.gouv pour l’instant). Dis-moi ce que tu en penses.

Je n'ai pas encore précisé ni dans le titre ni dans le back office la commune concernée par ces jeux je souhaite bien avoir leur aval avant de l'indiquer

Par ailleurs, il sera nécessaire d'avoir l'accord pour l'utilisation de la licence ouverte.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants