Skip to content
GitLab
  • Menu
Projects Groups Snippets
  • /
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
  • S Schéma Base adresse locale
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 2
    • Issues 2
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 0
    • Merge requests 0
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
  • Deployments
    • Deployments
    • Environments
    • Releases
  • Packages & Registries
    • Packages & Registries
    • Container Registry
  • Monitor
    • Monitor
    • Incidents
  • Analytics
    • Analytics
    • Value stream
    • CI/CD
    • Repository
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar
  • SCDL
  • Schéma Base adresse locale
  • Issues
  • #6
Closed
Open
Created Oct 25, 2018 by Charles Nepote@CharlesNepote

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
Edited Dec 13, 2018 by Pierre Dittgen
Assignee
Assign to
Time tracking

OpenDataFrance.net