مشروع 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، ومستخدمي قاعدة البيانات مقارنةً بمستخدمي نظام التشغيل وملكيتهم.

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، والاطّلاع على المنتديات للتعرّف على مشاكل الإعداد المتكرّرة، والاستعانة بمرشدين للتأكّد من اتّباع أفضل الممارسات بشكل صحيح وشرح أهم المفاهيم بدون تبسيطها بشكل مفرط.