Le Citation File Format a permis aux logiciels de se citer eux-mêmes depuis la racine du dépôt

Les articles ont une page de titre ; les logiciels de recherche souvent n'en avaient pas. Les utilisateurs pouvaient voir le code mais pas la liste exacte des auteurs, la version, le DOI ou la citation préférée, si bien que les logiciels étaient cités de manière incohérente, voire pas du tout.

Le Citation File Format a résolu ce problème avec presque aucune infrastructure. Un mainteneur ajoute `CITATION.cff`, un fichier YAML en texte brut, à la racine du dépôt. Le fichier indique aux personnes et aux machines exactement comment citer le logiciel ou le jeu de données.

Le levier d'adoption a été le soutien des plateformes. GitHub lit CFF et expose une invite « Citer ce dépôt » avec une sortie en APA et BibTeX ; Zenodo et Zotero peuvent réutiliser les mêmes métadonnées plutôt que de demander aux auteurs de les saisir à nouveau.

Placer les métadonnées de citation à côté du code

Le nom de fichier est conventionnel et repérable à la racine du dépôt.

YAML a permis de garder le fichier rédigéable par un humain tout en restant suffisamment structuré pour la validation et la conversion.

Le rendu par les plateformes a transformé une convention de mainteneur en flux de travail pour l'utilisateur final.

Les citations préférées permettent au logiciel de pointer vers un article ou un jeu de données sans perdre les métadonnées du logiciel.

Lorsque l'attribution est le problème, la meilleure norme peut être un petit fichier à l'endroit où les utilisateurs cherchent déjà le projet.

CFF est devenu un pont pratique entre l'hébergement de code et la citation savante. GitHub documente la prise en charge directe des fichiers CITATION.cff et les rend en APA et BibTeX, tandis que le projet CFF indique le soutien de GitHub, Zenodo et Zotero.