وقت القراءة المقدر : 5 min · تاريخ النشر
إنشاء المصدر والنطاق
وصف المنتج وطريقة التجميع والفترة الزمنية والتغطية الجغرافية أو الموضوعية. تمييز تواريخ الاستخراج والتحديث والقياس. قد يصف ملف نُشر اليوم قياسًا سابقًا ؛ النشر لا يغير السنة المرجعية.
الدولة المفقودة والقيم التقريبية حيث يحددها المصدر. لا تملأ الفجوة بتقدير لم يكشف عنه. تتناول إرشادات توثيق Data.Gouv.fr سياق الإنتاج والهيكل والتناقضات المحتملة.
تقديم قاموس ومثال
اشرح كل حقل ووحدة ونوع وقيمة مفقودة ورمز مرجعي. قدم مثالًا صغيرًا يمكن قراءته يتوافق مع مجموعة البيانات الكاملة. حيث تنضم المعرفات إلى الجداول ، قم بتوثيق العلاقات والصفوف التي يحتمل أن تكون لا مثيل لها.
تميز الكيانات عن تسمياتها. قد يكون للبلدية العديد من الرموز البريدية ومنتج العديد من المتغيرات. يجب أن تساعد الوثائق في منع التجميع المضلل أو إلغاء البيانات المكررة الذي يزيل علاقة مفيدة.
وثّق المرجع وترتيب الإحداثيات في البيانات الجغرافية، لا اسم الصيغة فقط. تعرّف RFC 7946 صيغة GeoJSON بمرجع WGS 84 والدرجات العشرية؛ أول قيمتين هما خط الطول ثم خط العرض. في تمرين افتراضي، يجب ألا يتحول Point [2.35,48.86] إلى [48.86,2.35]. كلا المصفوفتين JSON قابل للقراءة والأرقام معقولة؛ التحقق النحوي وحده لا يكتشف الانعكاس.
ميّز كيانًا غير محدد الموضع عن نقطة معروفة. يمكن أن تكون geometry في Feature غير محددة الموضع مساوية null؛ ولا يساوي ذلك Point بإحداثيات خالية أو استبدال المجهول بـ[0,0]، وهو موضع حقيقي. اشرح أيضًا هل تمثل النقطة مدخلًا مرصودًا أم عنوانًا محولًا لإحداثيات أم مركزًا محسوبًا، مع المصدر والتاريخ. زيادة المنازل العشرية لا تجعل التقدير أكثر يقينًا.
مرّر الجدول أفقيًا لقراءة جميع الأعمدة. باستخدام لوحة المفاتيح، انقل التركيز إلى الجدول ثم استخدم مفاتيح الأسهم.
| الحالة | التفسير | الفحص المفيد |
|---|---|---|
| Point · coordinates: [2.35,48.86] | خط الطول 2.35؛ خط العرض 48.86 | المقارنة بحقول المصدر المسماة |
| Point · coordinates: [48.86,2.35] | رقمان معقولان بترتيب معكوس في التمرين | فحص المعنى؛ لا تكفي الصياغة |
| Feature · geometry: null | كيان غير محدد الموضع؛ جزء من البنية | توثيق الغياب دون اختراع نقطة |
| الموضع [0,0] | إحداثيات موجودة وليست غيابًا | عدم استخدامها بديلًا تلقائيًا للمجهول |
تحقق من النشر وإعادة الاستخدام
تحديد شروط إعادة استخدام المصدر ومعلومات الإسناد التي يجب الاحتفاظ بها. اطلب من المراجعين المناسبين تقييم حقوق النشر والبيانات الشخصية المحتملة قبل الإصدار العام. لا يجعل العنوان المرئي في مكان آخر كل نسخة مناسبة للنشر تلقائيًا.
اختبار التنزيلات بدون أدوات داخلية أو حسابات خاصة عند الوعد بالوصول العام. تحقق من التنسيق والتشفير والنزاهة. قدم مرجعًا للإصدار أو المجموع الاختباري بحيث يمكن ربط التعليقات بالملف الذي تم تنزيله.
الحفاظ على الإصدارات والتصحيحات
اختر تردد مراجعة واقعي واتصال للقضايا. وصف الحقول المضافة أو المزالة أو المعاد تعريفها عند تغيير المخططات. التمييز بين التصحيحات والقياسات الجديدة لتجنب إحداث تغييرات خاطئة في سلسلة زمنية.
احتفظ بالإصدارات والملاحظات المفيدة مع سياسة استبدال واضحة. يجب أن تسمح وثائق النشر لشخص آخر بإعادة إنتاج الاستخراج أو فهم حدوده. لا يحل عداد التنزيل محل جودة التوثيق.
التوثيق الأساسي: data.gouv.fr : Bien documenter un jeu de données.
ميزوا مجموعة البيانات عن توزيعاتها. قد يمثل ملف CSV وملف JSON المجموعة نفسها بتنسيقين؛ فلا تعدوهما تلقائيًا قياسين مستقلين. يعرّف DCAT التوزيع بأنه تمثيل محدد لمجموعة بيانات. قارنوا مع ذلك التغطية والدقة والحقول والإصدار؛ فالتوزيعات ليست بالضرورة متكافئة دون فقد معلومات.
أضيفوا معرّف إصدار وسجلًا يشرح التصحيحات. قد يبقى عنوان «أحدث إصدار» ثابتًا، لكن يجب تحديد الإصدار المستخدم فعلًا. ميزوا أيضًا التصحيح عن الملاحظة الجديدة؛ قياس شهر جديد لا يصحح الشهر السابق بمجرد وجوده. اشرحوا العلاقة بين الإصدارات والسلاسل قبل مقارنة الأرقام.
مرّر الجدول أفقيًا لقراءة جميع الأعمدة. باستخدام لوحة المفاتيح، انقل التركيز إلى الجدول ثم استخدم مفاتيح الأسهم.
| العنصر التوثيقي | ما يميزه | التحقق المفيد |
|---|---|---|
| مجموعة البيانات | الموضوع والنطاق والملاحظات الموصوفة. | بقاء الهوية مفهومة بصرف النظر عن تنسيق الملف. |
| توزيع CSV أو JSON | تمثيل محدد للمجموعة. | مقارنة الحقول والدقة والتغطية قبل افتراض التكافؤ. |
| إصدار محدد | حالة دقيقة وسجل تغيراتها. | العثور على الإصدار المشار إليه حتى لو تغير محتوى العنوان الحالي. |
| تصحيح أو فترة جديدة | قيمة منقحة أو ملاحظة مختلفة. | عدم تقديم شهر جديد بوصفه تصحيحًا تلقائيًا للسابق. |
- W3C DCAT 3 : التوزيعات
تم الاطلاع في 22 أكتوبر 2026؛ الفرق بين المجموعات وتمثيلاتها واحتمال اختلاف مقدار المعلومات المحفوظة.
- W3C : البيانات على الويب والإصدارات
تم الاطلاع في 22 أكتوبر 2026؛ معرّف الإصدار وسجله والملاحظات المتعلقة بفترات مختلفة.
المستندات المرجعية
- W3C - البيانات الموجودة على الويب أفضل الممارسات · مصدر تمت مراجعته
- IETF : GeoJSON RFC 7946 · مصدر تمت مراجعته
- data.gouv.fr : Bien documenter un jeu de données
تاريخ تحديث المحتوى
مراجع موثقة لهذا الموضوع
| المرجع | القيمة أو الصيغة | النطاق |
|---|---|---|
| RFC 4180 · CSV | text/csv · "a,b" | تُحاط الحقول التي تحتوي على فاصلة أو اقتباس أو سطر جديد باقتباس؛ وتُضاعف علامات الاقتباس الداخلية. |
| RFC 8259 · JSON | application/json · UTF-8 | لا يسمح JSON القياسي بالتعليقات أو الفاصلة الختامية؛ وتستخدم السلاسل علامات اقتباس مزدوجة. |
تشير التواريخ إلى الاطلاع على المراجع. هذه المعلومات ليست تدقيقاً للموقع ولا إعلاناً شاملاً عن المطابقة.
