كيف تنشر مشروعك البرمجي الأول وتعرضه بشكل يلفت الانتباه

مقدمة

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

أهداف التعلم

• اختيار نطاق صغير قابل للإنجاز.
• كتابة README يجيب عن أسئلة الزائر خلال دقيقة.
• تجهيز نسخة تجريبية ولقطات شاشة.
• اختيار ترخيص وحماية الأسرار قبل النشر.
• عرض المشروع وطلب ملاحظات بناءة.

1. صغير ومكتمل أفضل من كبير ونصف منتهٍ

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

2. README يبيع المشروع

الزائر يقرر خلال ثوانٍ. هيكل مقترح:

# متتبع المصاريف

تطبيق ويب بسيط لتسجيل المصاريف اليومية وعرضها حسب الفئة والشهر.

![لقطة شاشة للوحة الرئيسية](docs/screenshot.png)

**جرّبه:** https://example.com/demo

## الميزات
- إضافة مصروف بفئة وتاريخ
- رسم بياني شهري
- تصدير CSV

## التقنيات
Next.js · TypeScript · PostgreSQL

## التشغيل محلياً
\`\`\`bash
git clone https://github.com/you/expenses
cd expenses
cp .env.example .env    # عدّل القيم
npm install
npm run dev
\`\`\`

## خارطة الطريق
- [ ] حسابات متعددة
- [ ] تطبيق جوال

## الترخيص
MIT

• سطر واحد يشرح ما المشروع ولمن.
• لقطة شاشة أو صورة متحركة قصيرة.
• رابط تجربة إن أمكن.
• خطوات تشغيل مجرّبة على جهاز نظيف.

3. قبل الضغط على «نشر»: الأسرار

افحص المستودع قبل جعله عاماً:

git log -p | grep -iE "password|secret|api[_-]?key|token" | head

• ضع .env في .gitignore ووفر .env.example بقيم وهمية.
• إن رفعت سراً مرة، غيّره فوراً لدى مزوده؛ حذفه من آخر commit لا يكفي لأنه باقٍ في التاريخ.
• استخدم أداة مثل gitleaks في CI.

4. الترخيص

دون ترخيص، القانون لا يمنح الآخرين حق استخدام كودك. الشائع:

• MIT: متساهل، يسمح بكل شيء مع ذكر الحقوق.
• Apache-2.0: متساهل مع بند صريح لبراءات الاختراع.
• GPL-3.0: يلزم من يوزع نسخة معدلة بنشر مصدرها بالترخيص نفسه.

موقع choosealicense.com يساعدك في الاختيار.

5. نسخة تجريبية

منصات الاستضافة المجانية أو منخفضة التكلفة تكفي للتجربة. تأكد أن النسخة لا تستخدم بيانات حقيقية، وأن كلمات المرور الافتراضية ليست «admin/admin».

6. اعرضه في المجتمع

عند نشره في قسم «عرض المشاريع»:

• اشرح المشكلة التي يحلها ولماذا بنيته.
• اذكر ما تعلمته وما كان صعباً.
• اطلب ملاحظات محددة: «هل تصميم قاعدة البيانات مناسب للتوسع؟» أفضل من «ما رأيكم؟».
• رد على التعليقات بتقدير، حتى الناقدة منها.

تمرين عملي

1. اختر مشروعاً صغيراً لديك واكتب له README بالهيكل أعلاه.
2. اطلب من صديق تشغيله محلياً باتباع README فقط، ودوّن كل خطوة تعثر فيها، ثم أصلحها.
3. افحص التاريخ بحثاً عن أسرار، وأضف ترخيصاً، ثم انشره واعرضه في قسم المشاريع بعرب كود.

أخطاء شائعة

• README من سطر واحد أو مولّد تلقائياً بلا محتوى.
• خطوات تشغيل لم تُجرب على جهاز آخر.
• رفع ملف .env بالأسرار.
• انتظار الكمال قبل النشر.

الخلاصة

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

مصادر مقترحة

• موقع makeareadme.com.
• موقع choosealicense.com.
• توثيق GitHub: «About READMEs» و«Removing sensitive data from a repository».