etalab / transport-profil-netex-fr

Le contenu des normes des données de transport présentes sur le site https://normes.transport.data.gouv.fr.
https://normes.transport.data.gouv.fr
12 stars 9 forks source link

Ajout du document SIRI profil France #7

Closed fchabouis closed 2 years ago

fchabouis commented 2 years ago

Ajout du profil SIRI France au site normes.transport.data.gouv.fr. Le document est une conversion à partir d'un fichier word vers le format markdown.

Aurige commented 2 years ago

Je suis passé très rapidement sur le document (15 minutes), je vois qq pb:

Est-ce que l'on doit faire des commentaires dans le doc à ce stade ou juste des commentaires généraux ?

fchabouis commented 2 years ago

J'ai fait une de passe de nettoyage sur le document, le résultat est visible ici.

@Aurige je te laisse regarder si ça te convient.

Aurige commented 2 years ago

Super, c'est effectivement beaucoup mieux Comment souhaites-tu que l'on fasse les commentaire sur les points qui restent ? par exemple il y a un titre "Structuration du document" qui s'est retrouvé inclu dans un paragraphe, ou encore le tableau au début de 2.3 (Définition de la structure LEADER) a un problèle dans le rendu du choice (décallage des cellules)

Je me rends compte qu'il ne semble pas y avoir de moyen simple de commenter le doc dans sa forme "présentation" ... ça va être compliqué (la majorité n'acceptera pas d'aller au niveau Mardown) ! Tu vois une solution ?

fchabouis commented 2 years ago

Bonjour Christophe, Merci pour tes retours, je vais apporter les corrections nécessaires. Il va effectivement nous falloir imaginer un nouveau workflow de travail pour collaborer sur ces documents, nous pouvons regarder ensemble les possibilités offertes par github. Sur la PR actuelle, le fichier faisant ~14000 lignes il n'est pas possible d'afficher le diff et donc de faire des commentaires à des endroits spécifiques du document facilement. C'est parce que c'est le commit initial de création du fichier, et que le diff est par conséquent énorme. Les PR suivantes porteront sur des portions du document et j'ai espoir que nous trouvions un moyen de collaborer qui convienne au groupe de travail :crossed_fingers: .

Une fois les remarques que tu viens de faire corrigées, je pense que nous pourrons publier le document et essayer différentes manières de corriger ce qui reste à corriger, afin de trouver celle qui nous convient. Qu'en penses-tu ?

Aurige commented 2 years ago

Ok, on peut avancer comme (note que mes derniers commentaires ne sont pas exhaustifs: ce sont juste qq exemples pour savoir comment tu souhaites que l'on travaille). Le GT7 est le 20: serait il possible que tu participes pour commencer à essayer de caler un principe de contribution/relecture ? De mon côté je serais absent du 8 au 19 ...

fchabouis commented 2 years ago

Ok je peux participer au groupe le 20 pour présenter le document nouvellement mis en ligne. A nous de tester différentes méthodes de contributions d'ici là pour pouvoir en discuter le 20.