اجعل الزيارة الأولى للمستودع مفيدة
قبل مشاركة الرابط، افتح مستودعك كما لو كنت شخصًا لم يسمع به من قبل. ينبغي أن تشرح الشاشة الأولى المشكلة والمستخدم المستهدف وأقصر طريق لرؤية نتيجة. قد تفيد لقطة شاشة لأداة مرئية؛ أما للمكتبة البرمجية، فغالبًا ما يكون مثال صغير للمدخلات والمخرجات أنفع.
في أداة افتراضية للتحقق من CSV، تكون عبارة «تحقّق من ملفات CSV المُصدَّرة قبل استيرادها إلى قاعدة بياناتك» أوضح من «مجموعة أدوات قوية للبيانات». أتبعها بملف غير صالح نموذجي، وأمر فحصه، والخطأ الناتج عنه.
- ضع الغرض ومثالًا يعمل قبل قائمة الميزات الطويلة.
- اذكر متطلبات بيئة التشغيل وخطوات التثبيت والقيود المعروفة.
- أضف روابط للترخيص والوثائق والمكان المخصص للإبلاغ عن المشكلات.
- استخدم موضوعات دقيقة للمستودع حتى يتمكن متصفحو ذلك الموضوع من العثور على مشروعك.
اعثر على أول قرّائك المهتمين
اختر مجتمعًا يناقش بالفعل المشكلة التي تحلّها. تحتاج أداة بيانات Python إلى مقدمة تختلف عن أداة تصميم في المتصفح. اشرح حالة استخدام محددة وبيّن الجوانب التي تريد ملاحظات بشأنها. صرّح بأنك القائم على المشروع، واقرأ قواعد النشر في المجتمع أولًا.
اجعل التجربة الأولى محدودة: حسّن README، وشارك مثالًا واحدًا قابلًا للتشغيل في مكان مناسب، وأجب عن الأسئلة الناتجة. إذا تعذّر على القرّاء تثبيته، أصلح ذلك قبل إضافة قنوات أخرى. تكرار نشر الرابط نفسه لا يعوّض حل مشكلة البدء باستخدام المشروع.
اطلب نجمة بعد تقديم فائدة
يكفي سطر اختياري قصير بعد دليل البدء السريع: «إذا كان هذا المشروع مفيدًا لك، يمكنك منح المستودع نجمة للعثور عليه مجددًا». أبقِ تعليمات التثبيت والوثائق والدعم متاحة سواء منح الشخص نجمة أم لا.
يقدّم GitHubStart دليلًا عامًا لاكتشاف المشاريع وتبادل الدعم. يمكنك إدراج مستودع عام دون تسجيل الدخول إلى GitHubStart، وتصفّح المشاريع الأخرى، وتحديد ما تريد دعمه منها. تظل إضافة النجمة إجراءً يدويًا يتطلب تسجيل الدخول إلى GitHub. إدراج المستودع لا يَعِد بعدد من النجوم ولا بنجمة مقابلة.
استخدم سجلًا أسبوعيًا لما تتعلّمه
دوّن التاريخ والتغيير الذي أجريته ومكان مشاركته والأسئلة التي تلقيتها وما أصلحته. قارن النجوم بمؤشرات عملية مثل عمليات التثبيت الناجحة والمشكلات القابلة لإعادة الإنتاج والمساهمات المتكررة. الزيادة بعد منشور هي علاقة ارتباط، وليست دليلًا على أن كل نجمة جديدة جاءت من ذلك المنشور.
مثلًا: إذا سأل خمسة قرّاء عن إعداد رمز وصول، فانقل تعليمات الإعداد إلى ما قبل المثال. شارك المثال المصحّح معهم بدلًا من نشر إعلان إطلاق عام آخر.
- الأسبوع 1: تحقّق من دليل البدء السريع في بيئة نظيفة.
- الأسبوع 2: شارك حالة استخدام واحدة وردّ على الملاحظات.
- الأسبوع 3: انشر الإصلاحات واشرح ما تغيّر.
- الأسبوع 4: احتفظ بالقناة التي أنتجت نقاشات مفيدة وراجع البقية.
أسئلة شائعة
كيف أحصل على أول 100 نجمة على GitHub؟
اعتبر 100 محطةً تستهدفها، لا نتيجةً موعودة. ابدأ بمشروع قابل للاستخدام وREADME واضح وقرّاء مهتمين. تنطبق الخطوات نفسها عند 5 أو 500 نجمة؛ والوقت المطلوب يعتمد على الجمهور والمشروع.
هل يمكنني منح مستودع GitHub نجمة دون تسجيل الدخول؟
يمكنك تصفّح المستودعات العامة وGitHubStart دون حساب على الموقع. لمنح نجمة، يجب أن تسجّل الدخول إلى GitHub بنفسك. لا ينفّذ GitHubStart هذا الإجراء نيابةً عنك.
هل تعني النجوم الأكثر مستخدمين أكثر؟
ليس بالضرورة. قد يحفظ شخص المستودع لوقت لاحق دون تثبيته. تتبّع الاستخدام والملاحظات بصورة منفصلة عن عدد النجوم.