شرح صفوف ومحتوى الفقرة
يبدأ كل مستودع احترافي بملف توثيق واضح باسم README.md في مجلده الجذري؛ إذ تعرضه منصة GitHub تلقائياً كواجهة رئيسية للمشروع فور فتح صفحته، مما يجعله الانطباع الأول لأعضاء الفريق ومديري التوظيف والمستخدمين.
ويجب أن يجيب ملف README.md المتكامل عن أربعة أسئلة خلال ثوانٍ: ماذا يفعل هذا المشروع؟، وما المتطلبات المسبقة لتشغيله؟، وكيف أثبّته وأشغّله محلياً خطوة بخطوة؟، وكيف أشغّل الاختبارات؟
Shell
git add README.md
git commit -m "docs: add setup and test commands to README"
git push