Dans le contexte du projet Établi, une initiative représente soit un service, un produit ou un projet qui est géré par l'État ou par une collectivité territoriale.

Nous possédons une liste des sites internet d'initiatives publiques, ainsi qu'une autre liste représentant des dépôts de code informatique d'initiatives publiques.

Pour constituer une fiche, nous allons essayer de créer des groupes (= les fameuses initiatives) entre les sites internet et les dépôts. Car les initiatives peuvent être composées de plusieurs sites internet et/ou de plusieurs dépôts.

Assurez dans un premier temps que la fiche n'existe pas, en faisant une recherche avec votre nom de domaine et/ou l'adresse de votre dépôt.

Si vous n'en trouvez aucune dans notre propre annuaire, allez vérifier l'existence de vos sites et dépôts dans les listes sources que nous utilisons, et contribuez-y s'ils sont manquants.

Le flux d'information est unidirectionnel, nous utilisons le contenu des sites internet et des dépôts de code informatique pour établir les fiches d'initiatives. Il n'est donc pas possible de "patcher" la description produite dans la fiche sur Établi.

• S'il manque un site ou un dépôt à votre fiche, assurez-vous qu'il soit référencé dans nos sources ;
• Si le contenu vous paraît erroné :
  1. Vérifiez déjà que votre fiche initiative référence tous les sites internet et dépôts appropriés pour que notre algorithme ait le plus de contexte possible ;
  2. Si applicable, lisez la page d'accueil de votre site internet pour vous assurer qu'elle est assez explicite ;
  3. Si applicable, lisez la description de votre dépôt de code ou votre fichier README.md pour vous assurer qu'elle est assez explicite.

À noter que notre synthétisons l'information pour faire les fiches d'initiatives, il est possible que notre processus automatisé soit encore à optimiser. Si tel est le cas, merci de nous faire part de vos difficultés.

Tout d'abord il faut savoir que nous utilisons des sources externes à Établi (1 pour les sites, et 1 pour les dépôts de code informatique). Pourquoi ?

1. Ne pas maintenir cesdites sources nous permet de nous concentrer sur notre coeur de métier ;
2. Avoir 1 source par type de donnée est une volonté de notre part afin que la communauté au sens large se concentre sur l'amélioration de ces seules "sources de vérité", plutôt que de s'éparpiller.

Vous pouvez vous en servir pour vérifier qu'une initiative manquante sur Établi est bien absente des sources initiales, ou dans le cas où vous envisagez d'y référencer de nouveaux éléments. Les sources utilisées étant maintenues dans des dépôts de code informatique, n'hésitez pas à demander à vos collègues techniques voire à nous contacter si vous ne savez pas comment les faire évoluer.

Nos sources :

• Les sites internet sont extraits de la liste de noms de domaine de la sphère publique (en plus de ce qui est mentionné dans leur guide de contribution, il est envisageable d'y ouvrir une simple "issue" pour leur demander une modification) ;
• Et code.gouv.fr qui référence les dépôts de code informatique (comme mentionné dans leur guide de contribution, vous pouvez leur envoyer un email pour toute demande d'évolution).

Pour chaque nouveau référencement, il convient d'attendre quelques jours le temps que nos processus synchronisent les nouvelles données.

Lorsque vous modifiez des éléments sur votre site internet ou sur votre dépôt de code, cela peut prendre plusieurs jours avant que nos processus resynchronisent les dizaines de millier d'initiatives.

Si jamais cela vous paraît anormalement long, n'hésitez pas à nous contacter.

En nous basant sur une liste de noms de domaine et une liste de dépôts de code source, nous avons défini des règles pour les regrouper en petits groupes (dits "initiatives"). Il se peut que nos règles soient encore à optimiser, mais en voici quelques-unes qui augmentent les chances d'être dans un même groupe :

• Les sites internet sous un même nom de domaine avec une syntaxe similaire ;
• Les dépôts de code sous un même compte d'une forge, et avec une syntaxe commune dans leur nom ;
• Un site internet qui référence le lien vers son dépôt de code ;
• Un dépôt de code qui référence dans ses métadonnées le lien vers le site internet correspondant.

Si malgré cela vous n'arrivez pas à fusionner vos fiches, n'hésitez pas à nous contacter pour que l'on investigue la situation.

Nous n'enregistrons pas les recherches, qu'elles soient effectuées via l'annuaire ou par l'assistant.

Pour autant, nous vous demandons de ne pas y saisir d'informations sensibles.

Toutes nos données sont mises à disposition dans un format exploitable. Cela vous sera utile si vous développez une fonctionnalité basée sur nos données, ou que vous essayez de faire des filtres de recherche que notre interface ne propose pas.

Les jeux de données ci-dessous sont générés directement depuis notre base de données avec plus ou moins 1 jour de décalage. La donnée que vous exploiterez est donc à jour.

Pour les formats tableurs, plusieurs entités de même type pour une même initiative (sites internet, dépôts de code, cas d'utilisation et outils) sont regroupées dans une même cellule mais séparées par des retours à la ligne.

• Fichier JSON
  • Format technique
  • Format avec champs techniques traduits
• Fichier XLSX (pratique pour une exploration via logiciel type Excel)
  • Format technique
  • Format avec colonnes et champs techniques traduits
• Fichier CSV
  • Format technique
  • Format avec colonnes et champs techniques traduits

Notez que si vous êtes le premier de la journée à télécharger le jeu de données, il se peut que cela prenne quelques secondes au vu du grand nombre d'initiatives à formater dans le fichier.

La réalisation des prochains objectifs va forcément dépendre de l'impact que ce service aura auprès des agents et des citoyens. Mais nous avons quelques idées :

• Analyser si les sites internets possèdent des mentions légales et la déclaration d'accessibilité ;
• Analyser si les dépôts de code déclarent une licence d'utilisation ;

Si vous avez des idées pour nous, nous vous invitons à les partager via la messagerie !