لتوثيق مصدر مجموعة بيانات على جهاز Mac، قم بإنشاء ملف README بنص عادي بجوار البيانات وسجل جهة التزويد، أو الصفحة الأصلية أو المعرّف، وتاريخ التنزيل، والإصدار، والترخيص، وأي تغييرات أجريتها. احتفظ بهذه الملاحظة مع ملفات المشروع حتى يمكن العثور على المصدر مرة أخرى حتى لو فُقدت علامة Finder، أو الإشارة المرجعية، أو سجل التنزيل. هذا الدليل مخصص لمستخدمي Mac الذين يعملون مع مجلد مشروع محلي.

إنشاء ملاحظة مصدر بجوار مجموعة البيانات

في Finder، افتح مجلد المشروع واختر File > New Folder (أو اضغط على Shift-Command-N) إذا كنت بحاجة إلى مجلد للملف الأصلي وتوثيقه. قم بتسميته بوضوح، مثل data-source، أو احفظ الملاحظة في المجلد الذي يحتوي بالفعل على مجموعة البيانات. توثق شركة Apple أمر مجلد Finder هذا؛ كما أن الاحتفاظ بالبيانات الوصفية بالقرب من البيانات يتبع الإرشادات الحكومية لتسجيل معلومات مجموعات البيانات. تنظيم ملفاتك في Finder على Mac، تسجيل معلومات حول مجموعات البيانات التي تشاركها مع الآخرين

افتح TextEdit من Applications أو Spotlight. اختر Format > Make Plain Text، ثم أنشئ مستندًا جديدًا. يعد النص العادي خيارًا عمليًا لأنه يمكن فتحه بدون الحاجة إلى نفس تطبيق معالجة النصوص، كما يسهل قراءته جنبًا إلى جنب مع مجموعة البيانات؛ وتوصي Cornell Data Services باستخدام النص العادي لملفات README الخاصة بالبيانات. احفظه في نفس المجلد الذي توجد به مجموعة البيانات باسم README.txt أو README.md. إذا اقترح مربع حوار الحفظ في TextEdit امتداد نص منسق (rich-text)، فتحقق من اسم الملف والتنسيق قبل الحفظ؛ حيث قد تختلف صياغة القوائم ومربعات الحوار باختلاف إصدار macOS. كتابة ملفات README لبيانات البحث

تسجيل تفاصيل كافية لتحديد المصدر بدقة

استخدم سجلاً موجزًا مثل التالي، مع استبدال كل عنصر بما يمكنك التحقق منه. اترك الحقل محددًا كـ "غير معروف" (unknown) إذا لم تتمكن من تأكيده؛ ولا تخمن.

  • عنوان مجموعة البيانات واسم الملف:
  • جهة التزويد الأصلية أو المنشئ:
  • عنوان URL لصفحة المصدر أو المعرّف الدائم:
  • الإصدار، أو الطبعة، أو تاريخ النشر:
  • تاريخ الحصول عليها (YYYY-MM-DD):
  • الترخيص أو شروط إعادة الاستخدام، كما هو مذكور من قِبل جهة التزويد:
  • التغطية أو المحتويات ذات الصلة بهذا المشروع:
  • التغييرات التي أُجريت على النسخة التي تم تنزيلها:
  • الملفات أو الوثائق ذات الصلة:

يجب أن يشير عنوان URL لصفحة المصدر إلى صفحة مجموعة البيانات الخاصة بجهة التزويد كلما أمكن ذلك، بدلاً من الاقتصار على رابط تنزيل مؤقت فقط. أضف معرّفًا مثل DOI إذا كانت جهة التزويد توفر ذلك. تفرّق معايير فهارس مجموعات البيانات بين الصفحة المقصودة لمجموعة البيانات، والناشر، والترخيص، والإصدار، والمصدر الأصلي؛ ويسهل تسجيل هذه العناصر بشكل منفصل معرفة المكان الذي أتت منه النسخة والإصدار الذي تمثله. معايير البيانات: مجموعة البيانات

سجل التاريخ الذي قمت فيه بتنزيل الملف أو استلامه، وليس كما لو كان تاريخ إنشاء مجموعة البيانات. إذا كان بإمكانك التحقق من تاريخ إصدار أو تحديث جهة التزويد، فصنفه بشكل منفصل. استخدم الاسم الفعلي لجهة التزويد واكتب اسم المنظمة بالكامل بدلاً من الاعتماد على اختصار غامض. توصي إرشادات GOV.UK بتحديد من أنشأ مجموعة البيانات، ومتى تم إنشاؤها، ومعرّف مميز، وتنصح باستخدام "غير معروف" عندما تكون المعلومات غير متوفرة. تسجيل معلومات حول مجموعات البيانات التي تشاركها مع الآخرين

وصف ما حدث بعد التنزيل

يجب أن يفرّق سجل المصدر بين البيانات الأصلية لجهة التزويد والإصدار المستخدم في مشروعك. وضح ما إذا كنت قد أعدت تسمية الملفات، أو قمت بتصفية الصفوف، أو دمجت المصادر، أو حولت التنسيقات، أو صححت القيم. إذا كانت البيانات دون تغيير، فاذكر ذلك فقط إذا كنت متأكدًا منه. بالنسبة للملف المشتق، حدد اسم ملف الإدخال ولخص العملية؛ وضع رابطًا لبرنامج نصي (script) أو ملاحظة تحليل إذا كانت تحتوي على الخطوات القابلة للتكرار. توصي إرشادات توثيق البيانات الخاصة بـ Sandia تحديدًا بتسمية المصدر الأصلي للبيانات المشتقة وإدراج خطوات المعالجة. توثيق البيانات – مشاركة البيانات وفق مبادئ FAIR(ER)

على سبيل المثال، اكتب "تمت التصفية للصفوف المؤرخة بين 2022 و2024؛ وحُفظ باسم sales_2022_2024.csv" فقط عندما يصف ذلك عملك بدقة. لا تستبدل الملف الأصلي بصمت: احتفظ بنسخة غير ممسوسة عندما يكون ذلك ممكنًا، وامنح المخرجات المحولة أسماء ملفات مميزة. إذا كانت صفحة جهة التزويد تسرد ترخيصًا أو قيود استخدام، فسجل النص المذكور أو ضع رابطًا له؛ تساعد الملاحظة في تحديد موقع الشروط ولكنها لا تغني عن التحقق مما إذا كان استخدامك المخطط له مسموحًا به.

استخدام علامات Finder كاختصار فقط

يمكن أن تساعدك علامة Finder في تحديد موقع مجموعة البيانات أو ملف README لاحقًا. حدد العنصر في Finder، واختر File > Tags، أو انقر مع الضغط على مفتاح Control فوقه واختر علامة. تذكر Apple أنه يمكن استخدام العلامات للعثور على العناصر التي تم وضع علامات عليها من الشريط الجانبي لـ Finder أو البحث؛ العلامات هي تسميات للعثور على الملفات، وليست بديلاً عن توثيق جهة التزويد والإصدار والتغييرات في ملف README. استخدام العلامات لتنظيم الملفات على Mac

قبل اعتبار المصدر موثقًا، افتح ملف README من مجلد المشروع وتحقق من أن اسم الملف يطابق الملف الذي استخدمته، وأن عنوان URL أو المعرّف محدد بما يكفي لاسترداد المصدر، وأن لكل تاريخ معنى واضح. إذا لم تتمكن من تحديد إصدار دقيق، فاذكر هذا القيد في الملاحظة. إن سجلاً قصيرًا ودقيقًا أكثر فائدة من ملء كل حقل بالافتراضات.

المصادر