بحث
أدخل حرفين على الأقل دون بيانات شخصية.

    مكتبةالمقالات والأسئلة الشائعة مشروعكطلب عرض أسعار
    لغةAR ▾
    أدلة عملية

    نشر بيانات مفتوحة مفهومة وموثقة

    البيانات القابلة للتنزيل ليست بيانات مفهومة بعد. يحتاج المعيد إلى معرفة من أنتجه ، وما يغطيه ، وما يستبعده ، وكيفية تفسير مجالاته.

    انظر الطريقة

    صورة توضيحية — نشر بيانات مفتوحة مفهومة وموثقة
    رسم توضيحي مولّد بالذكاء الاصطناعي

    إنشاء المصدر والنطاق

    وصف المنتج وطريقة التجميع والفترة الزمنية والتغطية الجغرافية أو الموضوعية. تمييز تواريخ الاستخراج والتحديث والقياس. قد يصف ملف نُشر اليوم قياسًا سابقًا ؛ النشر لا يغير السنة المرجعية.

    الدولة المفقودة والقيم التقريبية حيث يحددها المصدر. لا تملأ الفجوة بتقدير لم يكشف عنه. تتناول إرشادات توثيق Data.Gouv.fr سياق الإنتاج والهيكل والتناقضات المحتملة.

    تقديم قاموس ومثال

    اشرح كل حقل ووحدة ونوع وقيمة مفقودة ورمز مرجعي. قدم مثالًا صغيرًا يمكن قراءته يتوافق مع مجموعة البيانات الكاملة. حيث تنضم المعرفات إلى الجداول ، قم بتوثيق العلاقات والصفوف التي يحتمل أن تكون لا مثيل لها.

    تميز الكيانات عن تسمياتها. قد يكون للبلدية العديد من الرموز البريدية ومنتج العديد من المتغيرات. يجب أن تساعد الوثائق في منع التجميع المضلل أو إلغاء البيانات المكررة الذي يزيل علاقة مفيدة.

    وثّق المرجع وترتيب الإحداثيات في البيانات الجغرافية، لا اسم الصيغة فقط. تعرّف ⁦RFC 7946⁩ صيغة ⁦GeoJSON⁩ بمرجع ⁦WGS 84⁩ والدرجات العشرية؛ أول قيمتين هما خط الطول ثم خط العرض. في تمرين افتراضي، يجب ألا يتحول ⁦Point⁩ ⁦[2.35,48.86]⁩ إلى ⁦[48.86,2.35]⁩. كلا المصفوفتين ⁦JSON⁩ قابل للقراءة والأرقام معقولة؛ التحقق النحوي وحده لا يكتشف الانعكاس.

    ميّز كيانًا غير محدد الموضع عن نقطة معروفة. يمكن أن تكون ⁦geometry⁩ في ⁦Feature⁩ غير محددة الموضع مساوية ⁦null⁩؛ ولا يساوي ذلك ⁦Point⁩ بإحداثيات خالية أو استبدال المجهول بـ⁦[0,0]⁩، وهو موضع حقيقي. اشرح أيضًا هل تمثل النقطة مدخلًا مرصودًا أم عنوانًا محولًا لإحداثيات أم مركزًا محسوبًا، مع المصدر والتاريخ. زيادة المنازل العشرية لا تجعل التقدير أكثر يقينًا.

    مرّر الجدول أفقيًا لقراءة جميع الأعمدة. باستخدام لوحة المفاتيح، انقل التركيز إلى الجدول ثم استخدم مفاتيح الأسهم.

    تمرين افتراضي: فحص المعنى بعد قابلية قراءة ⁦JSON⁩
    الحالةالتفسيرالفحص المفيد
    ⁦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تمثيل محدد للمجموعة.مقارنة الحقول والدقة والتغطية قبل افتراض التكافؤ.
    إصدار محددحالة دقيقة وسجل تغيراتها.العثور على الإصدار المشار إليه حتى لو تغير محتوى العنوان الحالي.
    تصحيح أو فترة جديدةقيمة منقحة أو ملاحظة مختلفة.عدم تقديم شهر جديد بوصفه تصحيحًا تلقائيًا للسابق.

    المستندات المرجعية

    تاريخ تحديث المحتوى

    مراجع موثقة لهذا الموضوع

    مراجع موثقة لهذا الموضوع
    المرجعالقيمة أو الصيغةالنطاق
    RFC 4180 · CSV
    text/csv · "a,b"تُحاط الحقول التي تحتوي على فاصلة أو اقتباس أو سطر جديد باقتباس؛ وتُضاعف علامات الاقتباس الداخلية.
    RFC 8259 · JSON
    application/json · UTF-8لا يسمح JSON القياسي بالتعليقات أو الفاصلة الختامية؛ وتستخدم السلاسل علامات اقتباس مزدوجة.

    تشير التواريخ إلى الاطلاع على المراجع. هذه المعلومات ليست تدقيقاً للموقع ولا إعلاناً شاملاً عن المطابقة.

    مصفوفة التحقق الوظيفي للتكيف مع المشروع

    تستخدم هذه الضوابط المقترحة حالات وهمية. حدد السلوك المتوقع مع الفريق ، واكتب النتيجة وقم بتعيين تناقضات لم يتم حلها قبل النشر.

    مرّر الجدول أفقيًا لقراءة جميع الأعمدة. باستخدام لوحة المفاتيح، انقل التركيز إلى الجدول ثم استخدم مفاتيح الأسهم.

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

    أسئلة مكررة

    أي تاريخ يجب أن يصاحب الملف؟

    عند الاقتضاء ، أظهر الاستخراج والتعديل الأخير والفترة المغطاة كتواريخ مسماة بشكل منفصل. لا تقدم وقت التنزيل تلقائيًا باعتباره السنة المرجعية للسكان أو أي قياس آخر.

    هل الترخيص وحده يجعل البيانات قابلة للاستخدام؟

    إنه يحدد شروط إعادة الاستخدام ، لكن الحقول والوحدات والمعرفات والتغطية والجودة والإصدارات تحتاج أيضًا إلى شرح. يجب أن يكون شخص آخر قادرًا على إعادة إنتاج أو على الأقل فهم الاستخدام.