GitHub

يجب أن يُعدّ HyoNova تطبيقه على GitHub قبل أن تستطيع شركة تثبيته.

يعرض تكامل GitHub حالة عملكم الهندسي بجانب العمل الذي تنتمي إليه. تربط المستودعات بالمشاريع، والمشكلات وطلبات الدمج بالمهام؛ ويعرض HyoNova هل كل منها مفتوح أو مغلق أو مدموج أو قيد المراجعة. وهو للقراءة فقط: «الكود يبقى على GitHub.»

ما يستطيع تطبيق GitHub قراءته#

تثبّت تطبيق GitHub، وتختار على GitHub المستودعات التي يُسمح له بقراءتها.

«HyoNova تقرأ عناوين المشكلات وطلبات الدمج وحالاتها فقط؛ لا تقرأ الكود ولا تستطيع تغيير أي شيء.»

ويحفظ HyoNova فقط المشكلات وطلبات الدمج التي ربطها شخص بمهمة، لا كل ما في المستودع.

عرض التفاصيل التقنية

صلاحيات التطبيق على المستودعات هي Metadata: Read-only وIssues: Read-only وPull requests: Read-only. وليست له صلاحيات على المنظمة ولا على الحساب. ويشترك في أحداث المشكلات وطلبات الدمج ومراجعات طلبات الدمج والمستودعات. والأحداث يوقّعها GitHub ويتحقق منها HyoNova قبل تطبيقها؛ ويُطبَّق كل حدث مرة واحدة، ولا يستبدل حدثٌ متأخر حالةً أحدث.

اربط GitHub#

للشركة اتصال GitHub واحد، وتثبيت GitHub الواحد يخص شركة واحدة في HyoNova.

إن لم يكتمل التثبيت#

بطاقة GitHub#

بعد الربط تعرض البطاقة حساب GitHub والمستودعات التي يستطيع التطبيق قراءتها — مع علامة خاص أو مؤرشف حيث ينطبق ذلك — ولكل مستودع المشاريع المرتبطة به، أو غير مرتبط بمشروع.

• مزامنة الآن يعيد قراءة المستودعات والعناصر المرتبطة من GitHub. ويعرض آخر مزامنة متى حدث ذلك آخر مرة.
• لإضافة مستودعات أو إزالتها، غيّر تثبيت التطبيق على GitHub. والمستودع الذي لم يعد التطبيق يستطيع قراءته يُوسم لم يعد متاحاً.
• إن قرأت البطاقة لا يملك التطبيق أي مستودع بعد، فأضف المستودعات إلى التثبيت على GitHub.

اربط مستودعاً بمشروع#

افتح مشروعاً واختر تبويب GitHub. اختر ربط مستودع GitHub، ثم اختر مستودعاً. يمكن أن يكون للمشروع عدة مستودعات، وأن يخدم المستودع عدة مشاريع.

ويعرض التبويب بعدها المستودعات المرتبطة مع فتح على GitHub، والعدّادين مشكلات مفتوحة مرتبطة وطلبات دمج مفتوحة مرتبطة، وقائمة المشكلات وطلبات الدمج المرتبطة من مهام المشروع. وإلغاء ربط المستودع يزيل الربط.

تحتاج إلى صلاحية تعديل المشاريع. وإن لم يكن GitHub مربوطاً بعد قرأ التبويب: GitHub غير مرتبط لهذه الشركة بعد.

اربط مشكلة أو طلب دمج بمهمة#

افتح مهمة واختر تبويب GitHub فيها.

وتعرض المهمة بعدها كل عنصر مرتبط برقمه وعنوانه، وحالته — مفتوح أو مغلق أو مدموج أو مسودة — وحالة مراجعة طلب الدمج (تمت الموافقة أو مطلوب تعديلات أو تمت المراجعة)، والمسؤولون عنه على GitHub، وآخر تحديث له. اختره لتفتحه على GitHub. وإزالة الربط يفصله عن المهمة.

تحتاج إلى صلاحية تعديل المهام.

طلب الدمج المدموج لا يُغلق مهمة#

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

والأمر نفسه في الاتجاه المعاكس: إكمال مهمة في HyoNova لا يغيّر شيئاً على GitHub.

مدى حداثة الحالة#

يُخبر GitHub نظام HyoNova حين تتغير مشكلة أو طلب دمج مرتبط. واحتياطاً يعيد HyoNova أيضاً قراءة العناصر المرتبطة المفتوحة التي لم يصله عنها شيء منذ يوم، ويفعل مزامنة الآن ذلك عند الطلب. وإن قرأت البطاقة المزامنة متأخرة أو خطأ في الاتصال فقد تكون الحالات المعروضة أقدم مما يعرضه GitHub.

الإيقاف المؤقت وفصل الاتصال#

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

وفصل الاتصال في HyoNova لا يغيّر شيئاً على GitHub. ولإزالة التطبيق هناك أيضاً، ألغِ تثبيته من إعدادات حسابك أو منظمتك على GitHub. ويمكنك كذلك تقليص مستودعات التطبيق هناك في أي وقت.

الحدود#

قد تحدّ خطتك عدد المستودعات. وحين ينطبق حدّ تعرض البطاقة مقدار المستخدَم.

ما لا تفعله هذه الميزة#

• لا تقرأ الكود ولا تعرضه.
• لا تنشئ مشكلات ولا تعلّق ولا تغيّر شيئاً على GitHub.
• لا تغلق المهام ولا تكملها ولا تنقلها تلقائياً.
• لا تستورد كل مشكلات المستودع: فقط ما تربطه.

الحالة#