etalab / doc.data.gouv.fr

Documentation du site data.gouv.fr.
https://doc.data.gouv.fr
MIT License
7 stars 53 forks source link

Page producteur #71

Closed AntoineAugusti closed 5 years ago

AntoineAugusti commented 5 years ago

La page https://doc.data.gouv.fr/faq/producteur/ rencontre plusieurs problèmes :

noirbizarre commented 5 years ago

Bonjour,

La documentation est en cours de réécriture cf. https://github.com/etalab/doc.data.gouv.fr/pull/70

Concernant les listes à puces. La syntaxe markdown ne prend pas en compte le chiffre dans le rendu, il est possible d'écrire une liste complète où toutes les entrées commencent par 1., elle serait quand même rendu numérotée. L’intérêt, en sachant que c'est une liste numérotée, est de pouvoir réordonner les entrées sans avoir à les renuméroter à la main. L'objectif, même si le markdown est joliment présenté par github, est vraiment d'être rendu dans la doc.

ex:

  1. puce numérotée 1
  2. puce aussi numérotée 1
  3. puce numérotée 42

Même si les nombres des puces ne sont pas les bons, quand tu lis ce commentaire, tu ne vois que le rendu qui lui est correcte :wink:

bboulesteix commented 5 years ago

La page en question est une page « historique », qui est vouée à disparaitre (voir #70). Tu as raison @AntoineAugusti, la page Producteur est perfectible, mais plutôt que de la refondre, je préfère la supprimer et m’en servir pour enrichir les articles qui sont déjà en ligne. Je ne crois pas que les pages publiés dernièrement (voir #36) souffrent des problèmes de Markdown que tu soulignes. Je ferme donc ce ticket. 👋