أمر رسمي في GitHub Copilot Chat· تحقّقنا منه 2026-10-20
الأمر نفسه يظهر للمشتركين

توليد توثيق للرمز في Copilot Chat

يضيف تعليق توثيق للرمز الحالي أو يولّد توثيقًا له.

تستخدمه إزاي؟

اكتب الأمر في أول رسالتك للأداة، وبعده طلبك بالتفصيل. الأمر نفسه وطرق كتابته متاحة للمشتركين.

الشرح

يطلب الأمر «الأمر» في GitHub Copilot Chat توثيق الرمز البرمجي الحالي، مثل دالة أو صنف. في Visual Studio تصفه الوثائق بأنه يضيف تعليق توثيق لهذا الرمز، وفي Xcode بأنه يولّد توثيقًا له. استخدمه حين تكتب دالة عامة سيستخدمها غيرك، أو حين تجد كودًا مهمًا بلا توثيق. راجع التوثيق الناتج بنفسك، لأن التوثيق الخاطئ أسوأ من غيابه: تأكد من أن وصف المعاملات والقيمة المرجعة والاستثناءات يطابق ما يفعله الكود فعلًا لا ما يبدو أنه يفعله.

طرق الاستخدام والمثال الجاهز للمشتركين

  • كل طرق كتابة الأمر ومعنى كل طريقة
  • مثال جاهز تنسخه بضغطة وتجرّبه على طول
  • نصائح لنتيجة أدق وأوامر مرتبطة

مشترك بالفعل؟ سجّل الدخول