ما الذي يجب أن تضعه في GitHub؟
GitHub هو منصة قوية لإدارة الأكواد والمشاريع البرمجية، ويمثل مكانًا مثاليًا لتخزين ومشاركة كود البرمجة، المراجع، والوثائق المتعلقة بمشاريعك. بشكل مختصر، يجب أن تضع في GitHub أي شيء مرتبط بالتطوير البرمجي أو المشاريع التقنية التي تعمل عليها.
أنواع الملفات والمشاريع المناسبة لوضعها في GitHub
تتعدد أنواع المشاريع التي يمكنك رفعها على GitHub، من بينها الشيفرات المصدرية للبرامج، سواء كانت برمجة ويب، تطبيقات سطح المكتب، تطبيقات الهاتف المحمول، أو حتى مشاريع تعلم الآلة. بإمكانك أيضًا رفع ملفات HTML، CSS، وJavaScript لمواقعك الإلكترونية، أو كود بايثون، جافا، C++* وغيرها من لغات البرمجة.
علاوة على ذلك، من المهم أن تضيف مستندات توضح كيفية استخدام المشروع، مثل ملفات README.md التي تعطي لمحة عامة عن المشروع وكيفية تشغيله أو تثبيته. هذه الملفات تساعد المستخدمين الآخرين على فهم هدف المشروع واستخدامه بشكل صحيح.
ملفات التوثيق والإدارة
يمكنك أيضًا تحميل ملفات التوثيق، مثل الخطط التقنية، خرائط سير العمل، وحتى التصميمات الأولية (wireframes) أو مستندات تسرد المتطلبات الخاصة بالمشروع. إضافة ملفات مثل LICENSE للتحكم في حقوق الاستخدام وكذلك CONTRIBUTING.md لتوجيه المساهمين المحتملين تعتبر من أفضل الممارسات في GitHub.
مشاركة الأكواد المفتوحة والعمل الجماعي
إذا كنت تنوي العمل مع فريق أو ترغب في فتح مشروعك كمصدر مفتوح، GitHub يتيح لك التعاون بسهولة من خلال نظام التحكم بالإصدارات Git، ويسمح للآخرين بإرسال طلبات تعديل (Pull Requests) ومناقشات حول التغييرات. لذلك، من المناسب أن تضع في GitHub المشاريع التي تراها جاهزة للمشاركة أو تحتاج إلى مساهمات عيدي المستوى.
ملفات أخرى مفيدة على GitHub
بجانب الأكواد، يمكن رفع سكربتات الأتمتة، ملفات التهيئة (configuration files)* قواعد البيانات الصغيرة أو عينات منها، وأحيانًا ملفات بيانات للاختبار (test data). كل هذه الأشياء تعزز من قيمة مشروعك وتجعل من السهل عليك إدارة العمل والتطوير مستقبلاً.
