تخطَّ إلى المحتوى

فرز الوارد

يبيّن هذا الدليل كيف تعمل بالوارد: السطح الواحد الذي يجمع كل ما يعطّلك أو يطلبك صراحة — موافقات الوكيل المعلّقة، ومزامنات التذاكر الفاشلة، وكل طلب سحب يخصّك مراجعًا أو مؤلفًا.

  1. انقر الوارد في الشريط الجانبي. تعدّ شارته موافقات الوكيل المعلّقة، والمزامنات الفاشلة، وطلبات السحب المفتوحة التي تنتظر مراجعتك.
  2. أو اضغط ⌘K وشغّل أمر الانتقال الوارد.
  3. أو افتح الرابط العميق /workspaces/<workspace-id>/inbox.

يعرض بند الشريط الجانبي العدد الحي دائمًا، فترى عمل الفرز يتراكم من غير فتح الصفحة.

امسح من الأعلى إلى الأسفل؛ الوارد مرتّب أصلًا حسب الإلحاح:

  1. يقع شريط يحتاج إلى انتباهك المثبّت فوق أقسام طلبات السحب. تحمل كل بطاقة شريحة خطورة. تُصدر المصادر المسجّلة (وكيل عالق عند مطالبة تأكيد، أو مزامنة تذكرة باتت مرآة مورّدها قديمة) متوقف.
  2. داخل الشريط تأتي درجة الخطورة الأشد أولًا؛ وعند التساوي يتقدّم البند الذي انتظر أطول مدة.
  3. تحت الشريط تُجمَّع طلبات السحب في أقسام ثابتة لدورة حياة المراجعة — بحاجة إلى مراجعتك، أُعيدت إليك، موافق عليها، المسودات، في انتظار المراجعين، قيد الدمج ومدمجة حديثًا، في انتظار المؤلف. الأقسام العليا هي ما يحتاج إليك؛ وسائرها حيث تقف طلبات سحبك. يشمل بحاجة إلى مراجعتك طلبات السحب التي ما زالت تطلب فريقًا تنتمي إليه، على المضيفين التي تدعم ذلك (يسقط GitHub الفريق ما إن يراجع أي زميل).

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

إن ضمّت مساحة العمل مستودعات على أكثر من مضيف شفرة، دمجها الوارد في مجرى واحد — يجاور طلب سحب من GitHub طلب سحب من Bitbucket في القسم نفسه، وهما مرتّبان بالوقت لا مجمّعان حسب الشركة. وما يفرّق بينهما سطر الصف repo #number.

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

المضيف المتوقف أو غير المتصل لا يساهم بشيء، ويُبقي سائر الوارد سليمًا — فاتصال واحد معطوب لا يفرغ القائمة كلها. تسمّي الحالة الفارغة تحفّظًا بدل لقد اطلعت على كل شيء حين يبقى تسجيل الدخول إلى كل مضيف بلا حل (تعذّر تأكيد حسابك على GitHub — والنص ما زال يسمّي GitHub)، أو حين يبلّغ githubstatus.com عن حادث، أو حين يُعلَّق تثبيت تطبيق GitHub الذي يغطي المستودعات المربوطة.

لكل بطاقة في الشريط إجراء تالٍ واحد:

  1. إن كانت البطاقة تأكيد وكيل معلّقًا، انقر مراجعة — تصل إلى مساحة ذلك الوكيل وتأكيدها المعلّق أمامك. وافق أو ارفض هناك (انظر الدردشة مع وكيل).
  2. إن قالت البطاقة فشلت المزامنة لمورّد، انقر فتح — تصل إلى الإعدادات ← مساحة العمل ← عام، وتعرض بطاقة سلامة المزامنة آخر مزامنة لكل اتصال، وسلسلة الإخفاقات المتتالية، وآخر نتيجة. لا يظهر في الوارد إلا آخر إخفاق لكل مورّد، فتعافي المزامنة يزيل البطاقة.
  3. تختفي البطاقات من تلقاء نفسها ما إن تُحَل الحالة التي تحتها (يُجاب الوكيل، أو تتعافى المزامنة) — ولا سبيل إلى إغلاقها يدويًا.
  1. اضغط f (من غير تركيز على حقل نص) لفتح قائمة التصفية، أو انقر زر تصفية في شريط الأدوات.
  2. اختر أي تركيبة من الحالة، والمؤلف، والمراجعون، والمحتوى، ومالك المستودع أو اسم المستودع، ونوافذ التاريخ، أو سريع المراجعة. يظهر إلى جوار كل خيار عدد بنود الوارد التي يطابقها.
  3. تظهر التصفيات النشطة شرائح في الشريط فوق القائمة؛ انقر ✕ الشريحة لإسقاط ذلك المعيار.
  4. استخدم الشريط الأيسر للانتقال بين الأقسام — يعرض كل بند عدده الحي، ويتبع التمييز موضع التمرير. انقر ترويسة قسم لطي أقسام لا تفرزها (مثل المسودات وأنت تصفّي المراجعات).
  5. انقر ترويسة عمود (العنوان، أو التغييرات، أو آخر تحديث) لترتيب كل قسم؛ وانقر العمود النشط مرة أخرى لعكس الاتجاه. يضبط زر خيارات العرض إظهار المسودات، والفترة الزمنية للمدموجة، وخصائص العرض، والترتيب والتجميع (وحده التجميع حسب المؤلف يغيّر تخطيط الوارد).

التصفيات هنا مستقلة عن قائمة طلبات السحب — تضييق الوارد لا يغيّر تصفيات القائمة، وتضييق القائمة لا يغيّر تصفيات الوارد.

  1. انقر أي صف لفتح صفحة تفاصيل طلب السحب.
  2. إن كان طلب السحب في بحاجة إلى مراجعتك، راجعه وقدّم قرارك — انظر مراجعة طلب سحب ودمجه.
  3. إن كان في أُعيدت إليك (طُلبت تغييرات أو فشل CI)، ادفع الإصلاحات من نسخة العمل لديك أو سلّم المتابعة إلى وكيل.
  4. إن كان في موافق عليها، ادمجه من صفحة التفاصيل.
  5. إن آثرت تفويض المراجعة على أن تقوم بها بنفسك، انظر إرسال وكلاء مراجعة ودورة حياة إرسال الوكيل.

ما إن تتغيّر الحالة الكامنة (تصل مراجعتك، أو يُدمَج طلب السحب)، يعيد المصنّف وضع طلب السحب في قسمه الجديد تلقائيًا.

  1. اضغط ⌘Z للتراجع عن آخر إجراء، و⌘⇧Z لإعادته.
  2. إن كان التركيز في حقل نص، يحرّر ⌘Z نص الحقل — انقر خارج الحقل أولًا لتتراجع عن إجراء على مستوى التطبيق.

ابحث عن الاختصارات في مكانها

قسم بعنوان “ابحث عن الاختصارات في مكانها”

اضغط ? (من غير تركيز على حقل نص) لفتح ورقة الاختصارات. تسرد كل اختصار نشط على المسار الحالي، ومنها اختصار تصفية الوارد f. الخريطة الكاملة في اختصارات لوحة المفاتيح.

  1. اضغط ⌘K في أي موضع لفتح لوحة الأوامر.
  2. اكتب الوارد للانتقال إلى الصفحة، أو اكتب عنوان طلب سحب — تعرض اللوحة طلبات السحب المطابقة وتفتح الذي تختاره.
  3. وأنت في الوارد، شغّل نسخ رابط هذه الصفحة لنسخ ذلك العنوان للمشاركة. ينسخ الأمر المسار الحالي، فهو عنوان الوارد حين تكون على هذه الصفحة.

يُحدَّث الوارد مباشرة، وإن شككت في قدم البيانات فانقر زر تحديث في شريط الأدوات — يفرض مسحًا فوريًا من جهة الخادم لكل مضيف متصل، ويعيد جلب تراكبات الدمج والمراجعة. تدور الأيقونة حتى تستقر كل عمليات الجلب.