Mac पर किसी डेटासेट के स्रोत का दस्तावेज़ीकरण करने के लिए, डेटा के पास ही एक प्लेन-टेक्स्ट README बनाएं और उसमें प्रदाता, मूल पेज या पहचानकर्ता, डाउनलोड तिथि, संस्करण, लाइसेंस और आपके द्वारा किए गए किसी भी बदलाव को दर्ज करें। उस नोट को प्रोजेक्ट फ़ाइलों के साथ ही रखें ताकि फाइंडर टैग, बुकमार्क या डाउनलोड हिस्ट्री खो जाने पर भी स्रोत को दोबारा खोजा जा सके। यह मार्गदर्शिका स्थानीय (लोकल) प्रोजेक्ट फ़ोल्डर के साथ काम करने वाले Mac उपयोगकर्ताओं के लिए है।

डेटासेट के पास एक स्रोत नोट बनाएं

Finder में, प्रोजेक्ट फ़ोल्डर खोलें और यदि आपको मूल फ़ाइल और उसके दस्तावेज़ीकरण के लिए किसी फ़ोल्डर की आवश्यकता है, तो File > New Folder चुनें (या Shift-Command-N दबाएं)। इसे कोई स्पष्ट नाम दें, जैसे कि data-source, या नोट को उसी फ़ोल्डर में सहेजें जिसमें डेटासेट पहले से मौजूद है। Apple इस Finder फ़ोल्डर कमांड को दस्तावेज़ीकृत करता है; डेटा के पास ही मेटाडेटा रखना डेटासेट की जानकारी दर्ज करने के सरकारी दिशानिर्देशों के अनुरूप है। Mac पर Finder में अपनी फ़ाइलें व्यवस्थित करें, दूसरों के साथ साझा किए जाने वाले डेटासेट के बारे में जानकारी दर्ज करें

Applications या Spotlight से TextEdit खोलें। Format > Make Plain Text चुनें, फिर एक नया दस्तावेज़ बनाएं। प्लेन टेक्स्ट एक व्यावहारिक विकल्प है क्योंकि इसे बिना किसी विशिष्ट वर्ड-प्रोसेसिंग ऐप के खोला जा सकता है और डेटासेट के साथ इसे पढ़ना आसान होता है; कॉर्नेल डेटा सर्विसेज (Cornell Data Services) डेटा README फ़ाइलों के लिए प्लेन टेक्स्ट की अनुशंसा करता है। इसे उसी फ़ोल्डर में डेटासेट के साथ README.txt या README.md के रूप में सहेजें। यदि TextEdit का सेव डायलॉग कोई रिच-टेक्स्ट एक्सटेंशन प्रस्तावित करता है, तो सहेजने से पहले फ़ाइल नाम और फ़ॉर्मेट की जांच कर लें; macOS संस्करण के अनुसार मेनू के शब्दों और डायलॉग में भिन्नता हो सकती है। शोध डेटा के लिए READMEs लिखना

सटीक स्रोत की पहचान के लिए पर्याप्त विवरण दर्ज करें

नीचे दिए गए संक्षिप्त रिकॉर्ड जैसे प्रारूप का उपयोग करें, और प्रत्येक संकेत (प्रॉम्प्ट) को उस जानकारी से बदलें जिसे आप सत्यापित कर सकते हैं। यदि आप किसी फ़ील्ड की पुष्टि नहीं कर सकते हैं, तो उसे "अज्ञात" (unknown) छोड़ दें; अनुमान न लगाएं।

  • डेटासेट शीर्षक और फ़ाइल नाम:
  • मूल प्रदाता या निर्माता:
  • स्रोत पेज का URL या स्थायी पहचानकर्ता (persistent identifier):
  • संस्करण, रिलीज़, या प्रकाशन तिथि:
  • प्राप्त करने की तिथि (YYYY-MM-DD):
  • प्रदाता द्वारा बताए गए लाइसेंस या पुनः उपयोग की शर्तें:
  • इस प्रोजेक्ट से संबंधित कवरेज या सामग्री:
  • डाउनलोड की गई प्रति में किए गए बदलाव:
  • संबंधित फ़ाइलें या दस्तावेज़:

स्रोत पेज का URL केवल किसी अस्थायी डाउनलोड लिंक के बजाय, उपलब्ध होने पर प्रदाता के डेटासेट पेज की ओर इंगित करना चाहिए। यदि प्रदाता कोई पहचानकर्ता (जैसे कि DOI) प्रदान करता है, तो उसे जोड़ें। डेटासेट कैटलॉग मानक डेटासेट के लैंडिंग पेज, प्रकाशक, लाइसेंस, संस्करण और उद्गम (provenance) में अंतर करते हैं; इन्हें अलग-अलग दर्ज करने से यह जानना आसान हो जाता है कि कोई प्रतिलिपि कहाँ से आई है और यह किस रिलीज़ का प्रतिनिधित्व करती है। डेटा मानक: डेटासेट

फ़ाइल डाउनलोड करने या प्राप्त करने की तिथि दर्ज करें, न कि उसे इस प्रकार लिखें जैसे वह डेटासेट के निर्माण की तिथि हो। यदि आप किसी प्रदाता की रिलीज़ या अपडेट तिथि को सत्यापित कर सकते हैं, तो उसे अलग से लेबल करें। किसी अस्पष्ट संक्षिप्त नाम (abbreviation) पर निर्भर रहने के बजाय प्रदाता के वास्तविक शीर्षक का उपयोग करें और संगठन का पूरा नाम लिखें। GOV.UK का मार्गदर्शन यह पहचानने की सलाह देता है कि डेटासेट किसने बनाया, यह कब बनाया गया, और इसका एक विशिष्ट पहचानकर्ता क्या है, साथ ही जानकारी उपलब्ध न होने पर "अज्ञात" (unknown) का उपयोग करने की सलाह देता है। दूसरों के साथ साझा किए जाने वाले डेटासेट के बारे में जानकारी दर्ज करें

बताएं कि डाउनलोड के बाद क्या हुआ

स्रोत रिकॉर्ड में प्रदाता के मूल डेटा और आपके प्रोजेक्ट में उपयोग किए गए संस्करण के बीच स्पष्ट अंतर होना चाहिए। उल्लेख करें कि क्या आपने फ़ाइलों का नाम बदला, पंक्तियों को फ़िल्टर किया, स्रोतों को संयोजित किया, फ़ॉर्मेट बदला, या मानों (values) को ठीक किया। यदि डेटा अपरिवर्तित है, तो ऐसा केवल तभी लिखें जब आप यह निश्चित रूप से जानते हों। व्युत्पन्न (derived) फ़ाइल के लिए, इनपुट फ़ाइल नाम की पहचान करें और प्रक्रिया का संक्षेप में विवरण दें; यदि इसमें पुनरुत्पादक चरण (reproducible steps) शामिल हैं, तो किसी स्क्रिप्ट या विश्लेषण नोट का लिंक दें। सैंडिया का डेटा दस्तावेज़ीकरण मार्गदर्शन विशेष रूप से व्युत्पन्न डेटा के लिए मूल स्रोत का नाम बताने और प्रसंस्करण चरणों को सूचीबद्ध करने की अनुशंसा करता है। डेटा दस्तावेज़ीकरण – FAIR(ER) डेटा शेयरिंग

उदाहरण के लिए, केवल तभी “2022–2024 दिनांकित पंक्तियों में फ़िल्टर किया गया; sales_2022_2024.csv के रूप में सहेजा गया” लिखें जब यह आपके काम का सटीक वर्णन करता हो। मूल फ़ाइल को बिना बताए न बदलें: जब संभव हो तो एक अछूती प्रति रखें और रूपांतरित आउटपुट को अलग फ़ाइल नाम दें। यदि प्रदाता का पेज किसी लाइसेंस या उपयोग प्रतिबंधों को सूचीबद्ध करता है, तो उल्लिखित शब्दों को दर्ज करें या उसका लिंक दें; यह नोट शर्तों को खोजने में मदद करता है लेकिन यह जांचने का विकल्प नहीं है कि आपका नियोजित उपयोग अनुमत है या नहीं।

केवल शॉर्टकट के रूप में Finder टैग का उपयोग करें

Finder टैग बाद में डेटासेट या README का पता लगाने में आपकी मदद कर सकता है। Finder में आइटम का चयन करें, File > Tags चुनें, या उस पर Control-क्लिक करें और कोई टैग चुनें। Apple का कहना है कि टैग का उपयोग Finder साइडबार या खोज से टैग किए गए आइटम खोजने के लिए किया जा सकता है; टैग फ़ाइलों को खोजने के लिए लेबल हैं, README में प्रदाता, रिलीज़ और परिवर्तनों के दस्तावेज़ीकरण का विकल्प नहीं। Mac पर फ़ाइलों को व्यवस्थित करने के लिए टैग का उपयोग करें

स्रोत को दस्तावेज़ीकृत मानने से पहले, प्रोजेक्ट फ़ोल्डर से README खोलें और जांचें कि इसका फ़ाइल नाम आपके द्वारा उपयोग की गई फ़ाइल से मेल खाता है, इसका URL या पहचानकर्ता स्रोत को पुनः प्राप्त करने के लिए पर्याप्त विशिष्ट है, और प्रत्येक तिथि का एक स्पष्ट अर्थ है। यदि आप किसी सटीक संस्करण की पहचान नहीं कर सकते हैं, तो नोट में उस सीमा का उल्लेख करें। हर फ़ील्ड को अनुमानों से भरने की तुलना में एक संक्षिप्त, सटीक रिकॉर्ड अधिक उपयोगी होता है।

स्रोत