مشروع PostgreSQL

تحتوي هذه الصفحة على تفاصيل مشروع كتابة تقنيّة تم قبوله في موسم المستندات من Google.

ملخص المشروع

المؤسسة المفتوحة المصدر:
PostgreSQL
الكاتب التقني:
lu
اسم المشروع:
برنامج تعليمي تمهيدي
مدة المشروع:
المدة العادية (3 أشهر)

وصف المشروع

تحديث البرنامج التعليمي التمهيدي لتحسين تجربة تثبيت PostgreSQL وإعدادها للمبتدئين. (https://www.postgresql.org/docs/current/tutorial-start.html)

  1. يمكنك تحويل فصل "الأساسيات المعمارية" إلى مقدمة شاملة للأدلة التعليمية لـ PostgreSQL (https://www.postgresql.org/docs/current/tutorial-arch.html). من الأشياء التي يمكن التوسع فيها بنية الخادم العميل، و psql كمثال عميل لكي يتم استخدامه في هذا البرنامج التعليمي، مصطلح "التجميع" في سياق PostgreSQL، ومستخدمي DB مقابل نظام التشغيل والملكية.

  2. البرنامج التعليمي لتثبيت التحديث (https://www.postgresql.org/docs/current/tutorial-install.html).

    • أعلِن عن خيارَي التثبيت المصدر والثنائي. أضِف مرجعًا إلى https://www.postgresql.org/download/ يقدّم الحد الأدنى من تعليمات تثبيت البرنامج الثنائي.
    • حدِّد الثغرات في تعليمات تثبيت البرنامج الثنائي، إن وُجدت، ووسِّع الموقع الإلكتروني أو عالِجها في المستندات.
    • لا تعتمد على المستخدمين الذين يقرؤون فصل تثبيت المصدر بالكامل ويكتشفونه: حدد الخطوات الرئيسية المطلوبة بعد التثبيت، مثل تهيئة المجموعة وبدء تشغيل الخادم (تلقائيًا). يجب تقديم روابط إلى فصول معيّنة من المستندات للحصول على مزيد من التفاصيل حيثما ينطبق ذلك.
    • أضِف روابط أيضًا تؤدي إلى مراجع ذات صلة يتم توسيعها إلى الإعدادات التلقائية وأفضل الممارسات لنظام تشغيل معيّن، في حال كان المنتدى يعرف أيًّا منها.

  3. تحسين https://www.postgresql.org/docs/current/tutorial-createdb.html

    • تخلص من إرشادات "استشارة المشرف" حيثما أمكن؛ وقدم حلولاً قابلة للتنفيذ بناءً على افتراض أن المستخدم قد اتبع البرنامج التعليمي خطوة بخطوة.

  4. تحسين https://www.postgresql.org/docs/current/tutorial-accessdb.html

    • اشرح المشاكل الأساسية المتعلقة بالمصادقة وأمثلة بسيطة على صفحة pg_hba.conf.

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