هذه المرة قررت المشاركة في Hacktoberfest كمشرف على المشروع.

المشروع هو (AnadiCSV)[https://github.com/Cereal84/AnadiCSV] أداة بسيطة للاستعلام عن البيانات من ملف CSV عبر استعلام SQL.

تم كتابة AnadiCSV بلغة Python ويستخدم DuckDB وTextual، وقد تم تقديم المشروع إلى hacktoberfest في حالة جنينية. كانت الفكرة هي الاستفادة من مهرجان hacktoberfest لسببين:

• تعلم كيفية إدارة المشروع مع المساهمين "الخارجيين"
• تحسين الكود للسماح للأشخاص بالمساهمة.

الآن بعض الدروس التي تعلمتها حتى الآن.

كتابة القضايا التفصيلية

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

حاول إجراء حوار حول هذه القضية

قد لا تكون التفاصيل كافية، فمن الأفضل بدء حوار للتأكد من أن الجميع يفهم العمل الذي يتعين عليهم القيام به.

المساهمة في الملف مهم

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

إن إجراء مراجعة سيئة للكود ليس فكرة جيدة

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

إجراءات جيثب جيدة

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

خاتمة

حتى الآن تعلمت الكثير ويسعدني أن أبدأ هذا المشروع وأقترح على أي شخص أن يحاول القيام بنفس الشيء.

لأي شخص يبحث عن مشاكل في hacktoberfest، يرجى الحضور لزيارتنا :).