إملاء أوصاف طلبات السحب على GitHub

ملف الفروقات (diff) يقول أصلًا ما الذي تغيّر. أما الوصف فوجوده لقول السبب، والسبب نثر، وهو الجزء الذي يتساهل فيه الناس لأن كتابته آخر ما يفصلهم عن دمج الفرع.

سلوك خاص بطلبات السحب: النص معبّأ مسبقًا

إذا كان في المستودع ملف .github/pull_request_template.md، فإن GitHub يحمّله في حقل الوصف عند فتح طلب السحب. أنت لا تُملي مستندًا كاملًا، بل تُملي في الفراغات بين عناوين موجودة أصلًا. وهذا أسهل لا أصعب، بشرط أن تضع المؤشر عن قصد:

1. اقرأ القالب أولًا وقرّر ما سيوضع تحت كل عنوان قبل أن تبدأ بالكلام.
2. انقر في السطر الفارغ تحت أحد العناوين، وأملِ ذلك القسم، ثم توقف، ثم انقر في القسم التالي.
3. لا تُملِ كل شيء دفعة واحدة. نطق "new line" تحت عنوان خاطئ يدفن خطة الاختبار داخل الملخص.

الفخ: الأقواس المملاة تضع علامة في قائمة التحقق

معظم قوالب طلبات السحب قوائم تحقق مكتوبة على هيئة قوائم مهام. وعبارة مملاة مثل "open bracket x close bracket" تنتج مربعًا عليه علامة. وكذلك يفعل زوج أقواس زائد أضافه الإكمال التلقائي. والمراجع الذي يقرأ قالبًا وعلى كل مربعاته علامة سيفترض أنك أجريت الفحوص. تفقّد تبويب "Preview" بحثًا عن مربعات لم تضع عليها علامة عن قصد قبل أن تفتح طلب السحب.

تتصرف منتقيات الإشارات والمشكلات هنا تمامًا كما في المشكلات (issues): نطق "at" يفتح الإكمال التلقائي للمستخدمين، ونطق "hash" يفتح منتقي المشكلات. ويُرسل Command+Return الطلب.

ما تُمليه وما تكتبه

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

إملاء الوصف

1. فعّل الإملاء مرة واحدة: إعدادات النظام ← لوحة المفاتيح ← الإملاء. الخطوات الكاملة في تفعيل الإملاء على macOS.
2. افتح طلب السحب وانقر في حقل الوصف، قسمًا قسمًا.
3. أملِ نثر ذلك القسم، ثم توقف قبل تحريك المؤشر.
4. اكتب المعرّفات وكتل الشيفرة.
5. افتح تبويب "Preview"، وتحقق من مربعات الاختيار والإشارات، ثم أرسل.

إذا لم يُكتب شيء إطلاقًا

• يعمل GitHub داخل المتصفح، لذا فإذن الميكروفون يخص المتصفح وأداة الإملاء، ويوجد في إعدادات النظام ← الخصوصية والأمان (Privacy & Security) ← الميكروفون (Microphone).
• إذا كان الإملاء متوقفًا في كل مكان وليس في GitHub وحده: الإملاء لا يعمل على ماك.

اختصار واحد من المحرر إلى المراجعة

يُدخل Voice Type النص النهائي دفعة واحدة بدل بثّ ضغطات المفاتيح، فيبقى الإكمال التلقائي مغلقًا، ويعمل الاختصار نفسه في المحرر والطرفية وسلسلة المراجعة: الكتابة بالصوت على ماك.

تابع القراءة

• إملاء مشكلات GitHub دون إشعار الغرباء
• الكتابة بالصوت في VS Code (ومحرّك الإكمال الذي يعدّل تعليقاتك)
• الإملاء في Cursor

المصادر

• GitHub Docs: Creating a pull request template for your repository
• GitHub Docs: About task lists
• GitHub Docs: Keyboard shortcuts
• Apple: Dictate messages and documents on Mac