Pour documenter la source d’un jeu de données sur un Mac, créez un fichier README en texte brut à côté des données et consignez le fournisseur, la page d’origine ou l’identifiant, la date de téléchargement, la version, la licence et les éventuelles modifications apportées. Conservez cette note avec les fichiers du projet afin de pouvoir retrouver la source même si une balise du Finder, un signet ou l’historique des téléchargements venait à disparaître. Ce guide s’adresse aux utilisateurs de Mac travaillant dans un dossier de projet local.

Créer une note sur la source à côté du jeu de données

Dans le Finder, ouvrez le dossier du projet et choisissez Fichier > Nouveau dossier (ou appuyez sur Maj-Commande-N) si vous avez besoin d’un dossier pour le fichier original et sa documentation. Nommez-le clairement, par exemple data-source, ou enregistrez la note dans le dossier qui contient déjà le jeu de données. Apple documente cette commande de création de dossier dans le Finder ; conserver les métadonnées à proximité immédiate des données est conforme aux recommandations gouvernementales relatives à l’enregistrement des informations sur les jeux de données. Organiser ses fichiers dans le Finder sur Mac, Record information about data sets you share with others

Ouvrez TextEdit depuis les Applications ou via Spotlight. Choisissez Format > Convertir au format Texte, puis créez un nouveau document. Le texte brut est un choix pratique, car il peut être ouvert sans disposer du même logiciel de traitement de texte et se lit facilement aux côtés du jeu de données ; Cornell Data Services recommande le texte brut pour les fichiers README de données. Enregistrez-le dans le même dossier que le jeu de données sous le nom README.txt ou README.md. Si la boîte de dialogue d’enregistrement de TextEdit propose une extension de texte enrichi, vérifiez le nom du fichier et le format avant d’enregistrer ; l’intitulé des menus et les fenêtres de dialogue peuvent varier selon la version de macOS. Writing READMEs for Research Data

Consigner suffisamment de détails pour identifier la source exacte

Utilisez un modèle concis comme le suivant, en remplaçant chaque champ par les informations que vous pouvez vérifier. Laissez un champ avec la mention « inconnu » si vous ne pouvez pas le confirmer ; ne faites pas de suppositions.

  • Titre et nom de fichier du jeu de données :
  • Fournisseur ou créateur d’origine :
  • URL de la page source ou identifiant pérenne :
  • Version, édition ou date de publication :
  • Date d’obtention (AAAA-MM-JJ) :
  • Licence ou conditions de réutilisation, telles qu’indiquées par le fournisseur :
  • Couverture ou contenu pertinent pour ce projet :
  • Modifications apportées à la copie téléchargée :
  • Fichiers connexes ou documentation :

L’URL de la page source doit pointer vers la page du jeu de données du fournisseur lorsqu’elle est disponible, plutôt que vers un simple lien de téléchargement temporaire. Ajoutez un identifiant tel qu’un DOI si le fournisseur en propose un. Les normes relatives aux catalogues de données établissent une distinction entre la page d’accueil d’un jeu de données, son éditeur, sa licence, sa version et sa provenance ; consigner ces éléments séparément permet de déterminer plus facilement d’où provient une copie et à quelle version elle correspond. Data standards: Dataset

Indiquez la date à laquelle vous avez téléchargé ou reçu le fichier, sans la confondre avec la date de création du jeu de données. Si vous pouvez vérifier la date de publication ou de mise à jour fournie par l’éditeur, mentionnez-la séparément. Utilisez le titre officiel donné par le fournisseur et écrivez le nom complet de l’organisation plutôt que d’utiliser une abréviation ambiguë. Le guide de GOV.UK recommande d’identifier qui a créé le jeu de données, à quelle date, ainsi qu’un identifiant unique, et conseille d’inscrire la mention « inconnu » lorsqu’une information n’est pas disponible. Record information about data sets you share with others

Décrire ce qui a été fait après le téléchargement

Une fiche de source doit permettre de distinguer les données originales du fournisseur de la version exploitée dans votre projet. Précisez si vous avez renommé des fichiers, filtré des lignes, combiné des sources, converti des formats ou corrigé des valeurs. Si les données n’ont pas été modifiées, n’affirmez cela que si vous en êtes certain. Pour un fichier dérivé, identifiez le nom du fichier source et résumez l’opération ; ajoutez un lien vers un script ou une note d’analyse s’ils contiennent les étapes reproductibles. Le guide de documentation des données de Sandia recommande spécifiquement de citer la source d’origine pour les données dérivées et d’énumérer les étapes de traitement. Data Documentation – FAIR(ER) Data Sharing

Par exemple, n’écrivez « Filtré sur les lignes de 2022 à 2024 ; enregistré sous sales_2022_2024.csv » que si cela correspond fidèlement à votre travail. Ne remplacez pas le fichier original en cachette : conservez une copie intacte dans la mesure du possible et attribuez des noms de fichiers distincts aux résultats transformés. Si la page du fournisseur mentionne une licence ou des restrictions d’utilisation, consignez la formulation exacte ou insérez un lien vers celle-ci ; la note aide à retrouver les conditions applicables, mais ne vous dispense pas de vérifier si l’usage prévu est autorisé.

N’utiliser les balises du Finder que comme raccourci

Une balise (tag) du Finder peut vous aider à localiser ultérieurement le jeu de données ou le fichier README. Sélectionnez l’élément dans le Finder, choisissez Fichier > Balises, ou faites un clic avec la touche Contrôle enfoncée et choisissez une balise. Apple indique que les balises peuvent être utilisées pour retrouver des éléments balisés depuis la barre latérale du Finder ou via la recherche ; les balises sont des repères pour retrouver des fichiers, et non un substitut à la documentation du fournisseur, de la version et des modifications dans le fichier README. Utiliser des balises pour organiser les fichiers sur Mac

Avant de considérer la source comme documentée, ouvrez le fichier README depuis le dossier du projet et vérifiez que son nom de fichier correspond bien au fichier utilisé, que son URL ou son identifiant est suffisamment précis pour récupérer la source et que chaque date a une signification claire. Si vous ne pouvez pas identifier une version exacte, mentionnez cette limite dans la note. Une fiche brève et rigoureuse est bien plus utile que de remplir chaque champ avec des suppositions.

Sources