etalab / doc.data.gouv.fr

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

Supprime la section FAQ et déplace l’article sur les profils d’acheteurs #70

Closed bboulesteix closed 5 years ago

bboulesteix commented 5 years ago

9_shrink

Cette pull request supprime la section FAQ et l’intégralité des articles qui s’y trouvaient, à l’exception de l’article consacré aux profils d’acheteurs, qui est déplacé dans la section À propos — avec une redirection entre l’ancienne URL de l’article et la nouvelle.

La section FAQ est supprimée, comme annoncé dans #36, car son contenu est caduque, dépassé. J’en ai aussi profité pour éditer modérément l’article consacré aux profils d’acheteurs et en revoir la typographie.

noirbizarre commented 5 years ago

Du coup, est-ce que c'est possible de faire le même traitement que pour les profils d'acheteurs ? (ie. dans la section À propos avec une redirection)

(ce sont des URLs qu'on communique fréquemment)

bboulesteix commented 5 years ago

Hum, ce que contenait l’article Découvrir l’open data en tant que développeur est en grande partie couvert par l’article consacré au moissonnage et la documentation de l’API, non ? Je n’ai vraiment pas l’impression que nous perdions des informations en supprimant cet article. Mais je me trompe peut-être. 🤔 Si c’est le cas, je suis pour rajouter les informations manquantes aux articles sur l’API ou sur le moissonnage, plutôt que de laisser en ligne l’article Découvrir l’open data en tant que développeur.

Quant à l’article Découvrir l’open data en tant qu’intégrateur, il me semble un peu bavard. Il pourrait à mon avis être coupé et refondu dans un article Intégrer un jeu de données ou une organisation, article que je verrais bien figurer dans la section API ou Réutilisations et discussions. Qu’en dis-tu @noirbizarre ?

En résumé : la section FAQ doit bien disparaître, car son approche par métier n’est plus pertinente, nous étions d’accord sur ce point. Cela dit, je suis d’accord pour reprendre les informations intéressantes que la section FAQ — qui était d’ailleurs tout sauf une FAQ — contenait dans le but de créer de nouveaux articles ou d’enrichir des articles existants. 🙂

noirbizarre commented 5 years ago

OK pour moi sur le principe (transformer en articles, parce que ça ne va ni avec le moissonnage, ni avec l'API, ce sont bien des sujets distincts) comme solution cible. Mais, d'ici là, on fait quoi ?

  1. on suspend la PR jusqu'à ce qu'on ai pris le temps de le faire ?
  2. on maintient garde la section FAQ avec juste ces deux sections ?
bboulesteix commented 5 years ago

Merci pour ta réponse @noirbizarre.

Mais, d'ici là, on fait quoi ?

Solution 1. On met en pause cette pull-request. 👍

On la met en pause jusqu’à ce que :

  1. J’enrichisse les articles consacrés au moissonnage et à l’API avec ce qui était écrit dans Découvrir l’open data en tant que développeur ;
  2. J’ajoute un nouvel article dans la documentation pour expliquer comment intégrer des ressources de https://www.data.gouv.fr sur une page web.