GISarabia.org
PostGIS 3.6 · Official Manual · ترجمة عربية

فصل 14. الإبلاغ عن المشكلات

الصفحة الأصلية بالإنجليزية postgis.net ↗

فصل 14. الإبلاغ عن المشكلات

14.1. الإبلاغ عن أخطاء البرنامج

يُعد الإبلاغ الفعّال عن الأخطاء وسيلة أساسية للمساعدة في تطوير PostGIS. وأكثر بلاغات الأخطاء فاعلية هو الذي يُمكّن مطوري PostGIS من إعادة إنتاج الخطأ، لذا يُستحسن أن يتضمن سكربتًا يُطلقه وكل المعلومات المتعلقة بالبيئة التي اكتُشف فيها. ويمكن الحصول على معلومات كافية بتشغيل SELECT postgis_full_version() [لـ PostGIS] وSELECT version() [لـ postgresql].

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

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

قد ترغب في قراءة مقالة Simon Tatham حول كيفية الإبلاغ عن الأخطاء بفاعلية قبل تقديم بلاغ جديد.

14.2. الإبلاغ عن مشكلات التوثيق

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

يمكن أيضًا الإبلاغ عن مشكلات التوثيق في متتبّع أخطاء PostGIS.

إذا كان تعديلك بسيطًا، فاكتفِ بوصفه في بلاغ جديد في متتبّع الأخطاء، مع تحديد موضعه في التوثيق بدقة.

أما إذا كانت تغييراتك أوسع، فمن الأفضل حتمًا تقديم رقعة (patch). وهذه عملية من أربع خطوات على Unix (على افتراض أن git مثبّت لديك):

  1. انسخ (clone) مستودع git الخاص بـ PostGIS. على Unix، اكتب:

    git clone https://git.osgeo.org/gitea/postgis/postgis.git

    سيُخزَّن في الدليل postgis

  2. أجرِ تغييراتك على التوثيق باستخدام محرر النصوص المفضل لديك. على Unix، اكتب (على سبيل المثال):

    vim doc/postgis.xml

    لاحظ أن التوثيق مكتوب بلغة DocBook XML لا HTML، فإن لم تكن على دراية بها فاتّبع نهج بقية التوثيق.

  3. أنشئ ملف رقعة (patch) يحتوي على الفروق عن النسخة الرئيسية من التوثيق. على Unix، اكتب:

    git diff doc/postgis.xml > doc.patch

  4. أرفق الرقعة ببلاغ جديد في متتبّع الأخطاء.