Catalogue de symboles – Maintenance du catalogue

[mariondumont]

Après un premier échange avec le SG5, voici ce qui était envisagé :

• Gestion du catalogue côté CNIG, sous pilotage SG5

• Mise en place d’un catalogue consultable en ligne (format à définir dans une autre issue)

• Mise en place d’un formulaire de demande d’ajout au catalogue (de n’importe qui vers CNIG), ou a minima d’un canal de contact, avec les informations minimales (à compléter)

  • Intitulé de légende (une phrase)
  • Critères de sélection (si ces objets peuvent être isolés sur la base des attributs CNIG)
  • Justification de l’intérêt métier de distinguer ces objets par une représentation spécifique
  • Proposition de symbole (optionnel, format de la proposition à définir, penser qu’on aura pas forcément des experts de la symbo en face)

• Traitement des demandes d’ajout :

  • Etude de la pertinence de la demande (il faudrait qu’on essaye à terme d’avoir des « règles » d’acceptabilité pour limiter les débats et expliquer aux demandeurs en amont ce qui peut être ajouté ou non dans le catalogue) => ex. homogénéité du catalogue, la précision de la symbo doit être justifié par l’intérêt utilisateur, consensus métier, faisabilité technique, etc
  • Attribution d’un code SYMBOLE
  • Définition de la représentation graphique et validation de la faisabilité technique
  • Mise à jour du catalogue

• Alerte => GPU pour mise à jour du catalogue

Finalement, exceptée l’ouverture à tous et les codes SYMBOLE, tout ça ressemble fort à ce que le SG5 fait déjà sur les issues du Github à mon avis !

[GT-CNIG-DDU]

1/ Critères de sélection : il me semble que les objets doivent nécessairement pouvoir être filtrés sur la base des attributs du standard CNIG.

2/ Proposition de symbole : si pas en spécifications détaillées, on permet l'envoi d'une imagette qui sera traitée par le SG5 pour la traduire en spécifications ?

3/ Traitement des demandes d'ajout : on peut préciser qu'elle est instruite par le GT CNIG DDU / SG5

[GT-CNIG-DDU]

• Mise en place d’un catalogue consultable en ligne (format à définir dans une autre issue) => #75
• on permet l'envoi d'une imagette qui sera traitée par le SG5 pour la traduire en spécifications ? => #75

[alhyss]

Ci-après le processus évoqué par le SG5 du 2022.09.07, avec quelques précisions personnelles. A minima le demandeur est informé à chaque étape, mais le SG5 s'est accordé sur le fait qu'il serait préférable de publier les demandes et leur avancement. Permettre aux visiteurs d'exprimer leur soutien à une proposition en cours d'instruction pourrait être une fonctionnalité intéressante, pour identifier les demandes à traiter prioritairement ou qui semblent présenter un enjeu pour les utilisateurs.

Processus :

• Dépôt de la proposition d'ajout au catalogue.
• Réception par un membre du SG5 qui s'assure que toutes les informations nécessaires à l'instruction de la demande sont disponibles. Si nécessaire, sollicitation du demandeur pour compléments. Soumission (par mail ou équivalent) aux membres du SG5, pour vote sur l'opportunité de l'ajout au catalogue.
  • Si tous les votants sont en faveur de l'ajout, lancement immédiat de la création du symbole.
  • Si tous les votants s'opposent à l'ajout, rejet immédiat de la proposition.
  • Sinon, la décision est remise à la réunion suivante du SG5, à laquelle le demandeur peut être convié pour expliquer sa proposition, si ça présente un intérêt.
• Si l'opportunité de l'ajout du symbole est confirmée, création d'un symbole en bonne et due forme.
• Soumission aux membres du SG5, pour remarques puis vote de validation du symbole. Plusieurs itérations si besoin, voire examen en réunion du SG5.
• Une fois le symbole validé, publication dans le catalogue de symboles et implémentation sur le GPU.

À ce stade, il est retenu de permettre à toute personne physique ou morale de déposer une demande.

[nkulpinski]

Il serait possible d'utiliser les formulaire des issues de GitHub

[GT-CNIG-DDU]

Merci @nkulpinski pour cette proposition. Cette solution a des avantages (tout se passe dans Github) mais, connaissant l'outil je crains qu'elle paraisse un peu technique pour l'utilisateur lambda. Il faudrait pouvoir juger des aspects convivialité et intuitivité (par exemple : une connexion est-elle nécessaire ? etc..) à travers un prototype de formulaire de demande de création de symbole pour disposer de la vision orientée utilisateur.

[alhyss]

@nkulpinski J'aime bien l'idée d'utiliser les formulaires. C'est pragmatique. Je ne sais pas si ce sera suffisant, mais si oui on s'épargne la charge de la mise en place d'un nouveau système et de sa maintenance, et ça permet d'avoir une solution opérationnelle à court terme. Je suis favorable à ce que nous testions, et nous verrons à l'usage s'il est nécessaire d'aller plus loin.

Pour la visualisation du catalogue, une solution (assez) simple et sans double saisie consisterait à utiliser GitHub Pages et définir un workflow GitHub Actions pour mettre à jour automatiquement le contenu du site à chaque modification des sources sur le Git. À titre d'exemple, je l'ai implémenté sur ce Git pour générer la documentation technique de l'application. On peut certainement faire en sorte d'améliorer la mise en page (charte graphique de l'Etat, etc.), mais c'est déjà mieux que consulter le fichier Markdown directement sur le Git.

@GT-CNIG-DDU D'accord avec toi sur le fait que GitHub n'est pas un outil très accessible et, oui, il est nécessaire d'avoir un compte pour créer une issue. Je ne pense pas que ce niveau de technicité sera rédhibitoire pour la majorité des personnes qui vont être amenées à demander la création de symboles, mais il faudrait au moins prévoir un point de contact - une adresse mail ? - pour ceux qui rencontrent des difficultés. Au pire, ceux-là enverront tout par mail et nous créons l'issue nous-mêmes.

[GT-CNIG-DDU]

Je suis favorable à ce que nous testions, et nous verrons à l'usage s'il est nécessaire d'aller plus loin.

Entièrement d'accord car j'avoue ne pas avoir actuellement de vision claire des formulaires dans Github. @nkulpinski serait-il possible d'avoir un prototype d'ici le prochain SG5 du 4 avril ?

[nkulpinski]

@GT-CNIG-DDU je n'arrive malheureusement pas à accéder à cette possibilité car je n'ai pas accès aux réglage de notre GIT. Sinon celà aurait été avec plaisir. @alhyss super idée pour la documentation 😄 A mardi

[GT-CNIG-DDU]

@nkulpinski te voici admin du Git avec @alhyss et moi. En espérant que cela te donne accès aux paramètres nécessaires. A mardi

[nkulpinski]

👍

[GT-CNIG-DDU]

Processus :

* _Dépôt de la proposition d'ajout au catalogue._

• Une nouvelle codification du projet de standard doit systématiquement entraîner une issue créée par le GT DDU (SG5 du 04/09/23)

• Une proposition d'ajout au catalogue se fait via une issue formatée suivant la trame prévue (cf. le template d'issue)

  • Réception par un membre du SG5 qui s'assure que toutes les informations nécessaires à l'instruction de la demande sont disponibles. Si nécessaire, sollicitation du demandeur pour compléments. Soumission (par mail ou équivalent) aux membres du SG5, pour vote sur l'opportunité de l'ajout au catalogue.

    • Si tous les votants sont en faveur de l'ajout, lancement immédiat de la création du symbole.
    • Si tous les votants s'opposent à l'ajout, rejet immédiat de la proposition.
    • Sinon, la décision est remise à la réunion suivante du SG5, à laquelle le demandeur peut être convié pour expliquer sa proposition, si ça présente un intérêt.

  • Si l'opportunité de l'ajout du symbole est confirmée, création d'un symbole en bonne et due forme.

  • Soumission aux membres du SG5, pour remarques puis vote de validation du symbole. Plusieurs itérations si besoin, voire examen en réunion du SG5.

  • Une fois le symbole validé, publication dans le catalogue de symboles et implémentation sur le GPU. La publication dans le catalogue est automatisée. Je propose à @alhyss d'en détailler ici les grandes lignes

À ce stade, il est retenu de permettre à toute personne physique ou morale de déposer une demande.