جزاك الله خيرا

جزاك الله خيرا

وإياكم ✨

المنصة تبدو جميلة، تمنيت لو كانت بالعربية.

لدئ سؤال، في ماذا تحتاج المنصة إلى تعليقات؟ يبدو لي إن كل مشروع عبارة عن مستودع، يمكن كتابة issues فيه مباشرة، فأظن لا حاجة في أن تكون المنصة وسيط في التعليقات؟ ما هو تخيلك للتعليقات؟

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

لا مانع لدي بالتعاون مع dzcode، لكن في الحقيقة أفضل لو نستخدم مشروع مفتوح المصدر بالفعل مثل mkdocs مثلًا والتعامل ببساطة مع README files ولا حاجة لقاعدة بيانات في النهاية، أو ربما notion إن احتجنا (يتم سحب المحتوى أثناء عملية ال build ويكون في النهاية static website. أردت أن أنافش أيضًا ما هى معايير إضافة مشروع برمجي (ليس للتجمعية) بل مشروع مفتوح، يعمل عليه فريق مبادرة، أود ضمهم مجموعة لأضمن استمرارية هذه المشاريع، أعتقد أن كمنا بتوزيق الجهود بطريقة جيدة يمكننا أن نصل إلى نتائج ممتارة.

dzcode لديه قائمة جيدة بالمشاريع وبأسئلة واجابات يمكننا ترجمتها،
من الجميل أن نتكون من بلدان مختلفة لبناء مجهود عربي واحد، أؤمن بأن التناغم الثقافي هذا مهم ومن الممكن أن نبدع أن نظمنا العمل. يمكننا بناء Board هنا على github ومناقشة كل ما نريد من خلال ال issues، ربما يمكننا عمل نظام تصويت مثلًا.

يمكننا أن نأخذ منظمة gnome على سبيل المثال لنبني المجتمع الخاص بنا، نقوم أولًا بالتعرف على أنواع المهام التي لدينا. مثلًا، تصميم، برمجة، تعريب مصطلحات، ترجمة، التواصل مع المجتمع، وربما الفريق الأساسي الذي يضع الرؤية ويقود ال initiatives ومنها نبني المهام في الأقسام التي ذكرتها.

أعجبتني جدا فكرة الmarkdown files 🚀
وما فهمته أن إضافة المشروع ستكون من خلال notion forms مثلا.. (من الممكن استخدام google forms أيضا) وربما يكون للمشروع المضاف حالة قيد المراجعة مثلا حتى يتم الموافقة عليه
ونستخدم notion API في عرض المشاريع من notion database التي في حالتها أنه تمت الموافقة عليها..

❌ ولكن كيف سيكون التعديل ؟ سنعود لفكرتين أساسيتين:

• إما أن تكون المشاريع على هيئة JSON او markdown files المهم أنها ستكون في مستودع ما ويكون التعديل عن طريق pull requests
• أو يكون هناك خادم وقاعدة بيانات يتم حفظ فيه المشروع والتعامل مع التعديل (ربما يكون المستخدم الذي سيقوم بالتعديل هو صاحب المشروع أو ناشره.. وربما يكون شخص رأى خطأ ما فقام بطلب تعديل للمشروع وعندها الوضع الصحيح أنه يجب مراجعة طلبات التعديل مثل مراجعة طلبات الإضافة)

استكمالا لفكرة الmarkdown files

{
  "title": "تجميعةٌ",
  "descreption": "مستودع يحتوي على مجموعة من المشاريع (وليس حصرا لجميعها) للنهوض بالأمة، وبشكل رئيسي تلك المشاريع مفتوحة المصدر مثل لغات بالبرمجة ومعالجة اللغات الطبيعية م.ل.ط، بالإضافة لمشاريع متعلقة بالإسلام مثل تطبيقات القرآن والأذكار والأذان وغيرها.",
  "howToContribute": "يمكنك المساهمة بتوضيح خطأ لغوي أو اقتراح تحسينات أو إضافة أعمال ومشاريع أخرى تخدم الأمة، يمكنك فتح issue أو المشاركة في النقاشات.",
  "notes": [
    "لا بد أن نعي أن معظم هذه المشروعات تعتبر جهود فردية أو فريق بسيط له شؤون حياته الخاصة وتعلمه وعمله، ومعظمها بَطُؤ أو تَوقّف تطويره، فلا بد أن نتحمل مسؤولية دعم هذه المشروعات ودفعها للأمام، سواء أكان دعما ماديا أو مساهمة في التطوير",
    "فليكن هدفك الوحيد رضا الله، ولذا أنصح برخصة 'وقف' بدلا من رخص مثل GPL وال MIT، وغيرهما. كما يمكن إنشاء رخصة بها شروط مختلفة منطلقة من نفس المبدأ لمشاريعك المستقبلية إن شاء الله"
  ],
  "projects": [
    {
      "name": "Azkar - أذكار",
      "shortDescreption": "برنامج لسطح المكتب 💻 يساعدك على: معرفة مواقيت الصلاة 🕌، قراءة أذكار الصباح و المساء مع التذكير بها 🤲، ظهور إشعارات بذكر او دعاء عشوائي كل فترة محددة 💬.",
      "tags": ["Azkar", "PrayerTimes", "Desktop App"],
      "links": {
        "GitHub": "https://github.com/AbdelrahmanBayoumi/Azkar-App",
        "webstie": "https://azkar-site.web.app/"
      },
      "thumbnail": "https://azkar-site.web.app/assets/images/logo.png",
      "longDescreption": "/path/to/markdown/file/Azkar.md"
    },
    {
      "name": "Adhan",
      "shortDescreption": "High precision prayer time library",
      "tags": ["PrayerTimes"],
      "links": {
        "GitHub": "https://github.com/batoulapps/Adhan"
      },
      "thumbnail": "DEFAULT_THUMBNAIL",
      "longDescreption": "/path/to/markdown/file/Adhan.md"
    }
  ]
}

📌 هذا الملف يحتوي على المشاريع التي ستظهر (في تصوري) في الصفحة الرئيسية او عند البحث مثلا.. وعند الضغط على المشروع إذا كان يحتوي على longDescreption سيتم عرض الشرح/الوصف الخاص بالمشروع المتوفر في المستودع

إضافة مشروع:

تكون بإضافته في هذا الملف إضافة ملف markdown آخر لشرح المشروع إذا توفر (اختياري)

تعديل مشروع:

تكون بتعديله من هذا الملف أو تعديل الوصف/الشرح الخاص بالمشروع من ملف الmarkdown الموجود بالمستودع

@AbdelrahmanBayoumi @schehata @abderrahmaneMustapha

بالنسبة لنسخة نموذجية أولى، قد قمت بعمل deployment للتصميم الذي كنت أعمل عليه، وهو يعتمد على ال markdown، يمكن للتجمعية أن تكون مجموعة من الملفات أو ملف واحد، لا مشكلة. يمكن حتى آن تكون مجموعة من ملفات ال yaml. ألقوا نظرة على الموقع، أخبروني ما رأيكم وكيف نتقدم للأمام من هذه النقطة؟

يمكنك تصفح الموقع من هنا
الكود موجود بمستودع جديد داخل المنظمة.

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

لماذا نحتاج للتعليقات؟

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

كان بالإمكان توجيه من يريد التعليق أن ينشيء issue ويقدم فيها تعقيبه أو ملاحظته لكن الهدف من المنصة التسهيل والتنظيم، والخدمات المجانية متاحة لتوفير نظام للتعليقات.

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

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

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

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

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

أتفق معك تمامًِا.