Para documentar la fuente de un conjunto de datos en un Mac, cree un archivo README de texto sin formato junto a los datos y registre el proveedor, la página original o identificador, la fecha de descarga, la versión, la licencia y cualquier cambio que haya realizado. Guarde esa nota con los archivos del proyecto para que la fuente se pueda volver a encontrar incluso si se pierde una etiqueta de Finder, un marcador o el historial de descargas. Esta guía está dirigida a usuarios de Mac que trabajan con una carpeta de proyecto local.

Cree una nota sobre la fuente junto al conjunto de datos

En el Finder, abra la carpeta del proyecto y seleccione Archivo > Nueva carpeta (o presione Mayús-Comando-N) si necesita una carpeta para el archivo original y su documentación. Asígnele un nombre claro, como data-source, o guarde la nota en la carpeta que ya contiene el conjunto de datos. Apple documenta este comando de carpetas de Finder; mantener los metadatos cerca de los datos sigue las directrices gubernamentales para registrar información de conjuntos de datos. Organizar archivos en el Finder en la Mac, Record information about data sets you share with others

Abra TextEdit desde Aplicaciones o Spotlight. Seleccione Formato > Convertir a texto sin formato, luego cree un documento nuevo. El texto sin formato es una opción práctica porque se puede abrir sin necesidad de la misma aplicación de procesamiento de texto y es fácil de leer junto con el conjunto de datos; Cornell Data Services recomienda el texto sin formato para los archivos README de datos. Guárdelo en la misma carpeta que el conjunto de datos como README.txt o README.md. Si el cuadro de diálogo de guardado de TextEdit propone una extensión de texto enriquecido, revise el nombre del archivo y el formato antes de guardar; el texto de los menús y los cuadros de diálogo pueden variar según la versión de macOS. Writing READMEs for Research Data

Registre suficientes detalles para identificar la fuente exacta

Utilice un registro compacto como el siguiente, reemplazando cada indicación con lo que pueda verificar. Deje un campo marcado como “desconocido” si no puede confirmarlo; no haga suposiciones.

  • Título del conjunto de datos y nombre del archivo:
  • Proveedor o creador original:
  • URL de la página de origen o identificador persistente:
  • Versión, lanzamiento o fecha de publicación:
  • Fecha de obtención (AAAA-MM-DD):
  • Licencia o términos de reutilización, según lo indicado por el proveedor:
  • Cobertura o contenido relevante para este proyecto:
  • Cambios realizados a la copia descargada:
  • Archivos relacionados o documentación:

La URL de la página de origen debe dirigir a la página del conjunto de datos del proveedor siempre que esté disponible, en lugar de ser solo un enlace de descarga temporal. Añada un identificador como un DOI si el proveedor ofrece uno. Los estándares de catálogos de conjuntos de datos distinguen entre la página de destino, el editor, la licencia, la versión y la procedencia de un conjunto de datos; registrar estos datos por separado facilita saber de dónde proviene una copia y qué versión representa. Data standards: Dataset

Registre la fecha en la que descargó o recibió el archivo, no como si fuera la fecha de creación del conjunto de datos. Si puede verificar la fecha de lanzamiento o actualización de un proveedor, etiquétela por separado. Use el título real del proveedor y escriba el nombre completo de la organización en lugar de depender de una abreviatura ambigua. La guía de GOV.UK recomienda identificar quién creó un conjunto de datos, cuándo se creó y un identificador específico, y aconseja utilizar “desconocido” cuando la información no esté disponible. Record information about data sets you share with others

Describa lo sucedido después de la descarga

El registro de la fuente debe distinguir los datos originales del proveedor de la versión utilizada en su proyecto. Indique si cambió el nombre de los archivos, filtró filas, combinó fuentes, convirtió formatos o corrigió valores. Si los datos no han sufrido cambios, indíquelo solo si tiene certeza de ello. En el caso de un archivo derivado, identifique el nombre del archivo de entrada y resuma la operación; incluya un enlace a un script o a una nota de análisis si contiene los pasos reproducibles. La guía de documentación de datos de Sandia recomienda específicamente nombrar la fuente original para los datos derivados y enumerar los pasos de procesamiento. Data Documentation – FAIR(ER) Data Sharing

Por ejemplo, escriba “Filtrado a las filas fechadas entre 2022 y 2024; guardado como sales_2022_2024.csv” solo cuando eso describa con precisión su trabajo. No reemplace el archivo original silenciosamente: conserve una copia intacta cuando sea factible y asigne nombres de archivo distintos a los resultados transformados. Si la página del proveedor detalla una licencia o restricciones de uso, registre la redacción exacta o agregue un enlace a ella; la nota ayuda a localizar los términos, pero no reemplaza la verificación de si el uso que planea está permitido.

Utilice las etiquetas del Finder solo como un atajo

Una etiqueta del Finder puede ayudarle a localizar el conjunto de datos o el README más adelante. Seleccione el elemento en el Finder, elija Archivo > Etiquetas, o haga Control-clic sobre él y elija una etiqueta. Apple indica que las etiquetas se pueden utilizar para encontrar elementos etiquetados desde la barra lateral o mediante la búsqueda del Finder; las etiquetas son identificadores para encontrar archivos, no un sustituto de documentar el proveedor, la versión y los cambios en el archivo README. Usar etiquetas para organizar archivos en la Mac

Antes de dar por documentada la fuente, abra el archivo README desde la carpeta del proyecto y compruebe que su nombre de archivo coincida con el que utilizó, que su URL o identificador sea lo suficientemente específico para recuperar la fuente, y que cada fecha tenga un significado claro. Si no puede identificar una versión exacta, exponga esa limitación en la nota. Es más útil un registro breve y preciso que llenar cada campo con suposiciones.

Fuentes