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.

Le nom, la description et les cas d'utilisation de chaque fiche sont rédigés automatiquement par une intelligence artificielle, à partir de la page d'accueil des sites internet et de la présentation des dépôts. Un site qui ne correspond pas à un service public, ou dont le service a fermé, n'est pas répertorié.

Les organisations publiques qui portent chaque initiative sont retrouvées dans l'Annuaire de l'administration (nouvelle fenêtre), l'annuaire de l'Éducation nationale et les données de présence numérique des territoires.

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 nous 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.

Ils sont calculés automatiquement pour les sites internet de chaque initiative, uniquement à partir d'informations visibles publiquement :

• La notoriété provient d'un service tiers qui estime les liens que les autres sites internet font vers celui-ci (DataForSEO) ;
• Les en-têtes de sécurité HTTP sont notés par Mozilla HTTP Observatory (nouvelle fenêtre) ;
• Le certificat et les versions de TLS acceptées sont vérifiés en se connectant au site ;
• La protection des e-mails (SPF, DMARC) est lue dans les enregistrements DNS publics du nom de domaine ;
• La dépendance hors Union européenne regarde où sont hébergés le site et les ressources externes qu'il charge (scripts, polices, cartes…) ;
• Les mentions légales et la politique de confidentialité sont recherchées parmi les liens de la page d'accueil.

Ces indicateurs sont rafraîchis environ une fois par mois. Ils servent à repérer ce qui peut être amélioré et non à classer les initiatives : les services publics ne sont pas en concurrence. Une valeur peut être absente si le site n'a pas pu être analysé.

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 (nouvelle fenêtre) (en plus de ce qui est mentionné dans leur guide de contribution (nouvelle fenêtre), il est envisageable d'y ouvrir une simple "issue" pour leur demander une modification) ;
• Et code.gouv.fr (nouvelle fenêtre) qui référence les dépôts de code informatique (comme mentionné dans leur guide de contribution (nouvelle fenêtre), 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.

Nos processus relisent régulièrement les dizaines de milliers de sites internet et de dépôts de code (environ toutes les 3 semaines pour un site), il faut donc compter quelques semaines avant qu'une modification soit prise en compte.

Par ailleurs, une fiche n'est pas réécrite à chaque petite évolution :

• Elle l'est rapidement si le titre de la page d'accueil de votre site, ou le nom, la description ou l'adresse du site de votre dépôt changent ;
• Pour les autres changements du contenu du site ou du code du dépôt, seulement si sa description date de plus d'un an (respectivement six mois pour un dépôt), car ces changements modifient rarement la nature de l'initiative.

La date de la dernière rédaction est indiquée en bas de chaque fiche. 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. Ils contiennent les initiatives présentes dans l'annuaire, avec leurs organisations et leur notoriété, et la date de mise à jour correspond à la dernière rédaction de leur description.

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 (nouvelle fenêtre)
  • Format avec champs techniques traduits (nouvelle fenêtre)
• Fichier XLSX (pratique pour une exploration via logiciel type Excel)
  • Format technique (nouvelle fenêtre)
  • Format avec colonnes et champs techniques traduits (nouvelle fenêtre)
• Fichier CSV
  • Format technique (nouvelle fenêtre)
  • Format avec colonnes et champs techniques traduits (nouvelle fenêtre)

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 internet publient leur 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 !