Améliorer la lisibilité des README des dépôts des schémas
Je suis gêné que homepage
renvoie à une page difficile à lire pour une majorité d'acteur : https://git.opendatafrance.net/scdl/adresses
J'ai fait la même erreur pour les prénoms où je donne l'adresse suivante : https://github.com/CharlesNepote/liste-prenoms-nouveaux-nes
Ces pages relèvent de plateforme anglophone et où beaucoup d'informations sont obscures pour qui ne connaît pas les méthodes de développement logiciel basé sur des forges :
- Je me mets à la place d'un agent d'une petite collectivité qui souhaiterait se conformer au standard, il serait probablement bien dérouté en arrivant là.
- Je me mets aussi à la place d'un agent souhaitant remonter un problème ou converser avec les auteurs. Il faut avoir les "codes" pour savoir comment interagir.
Probablement serait-il plus judicieux de renvoyer vers la spec (la doc, pas le JSON) qui a le mérite d'être lisible pour tout un chacun. C'est cette doc qui devrait renvoyer les différents publics vers les modes d'interaction de leur choix. Exemple :
Pour remonter un problème, poser vos questions ou participer à l'évolution de ce standard, nous vous proposons :
- par email : xxxxxxxxxxx
- le forum d'aide et de discussions : https://teamopendata.fr/le-thread-dedie-a-cette-spec
- la forge de développement : https://git.opendatafrance.net/scdl/adresses