اختر المشروع العام والادعاء
ابدأ بمستودع عام محدد لمشروعك أو لمؤسسة تبحث فيها. انسخ اسم المالك واسم المستودع كاملين. اكتب بيان الميزة الدقيق الذي تحتاج إلى تحديده، وميّز بين التوثيق واختبار التنفيذ.
استخدم هذا الإجراء للعثور على توثيق المشروع. لا تبحث عن بيانات اعتماد مكشوفة أو معلومات اتصال خاصة أو طرق للالتفاف على ضوابط الوصول إلى المستودعات.
استخدم محددات بحث الشفرة بعناية
توضح وثائق بحث الشفرة في GitHub أن المصطلح المجرد قد يطابق مسار ملف أو محتوياته. repo: يقصر البحث على اسم مالك/مستودع كامل، وpath: يضيق المسارات، وcontent: يشترط وجود المصطلح في متن الملف. يمكن للسلاسل النصية بين علامتي اقتباس البحث عن صياغة دقيقة. تنطبق هذه القواعد على بحث الشفرة، وليس تلقائيًا على بحث المشكلات أو الملفات الشخصية. المصدر
لمستودع توضيحي باسم example-owner/example-project، قد يكون الاستعلام:
repo:example-owner/example-project content:"export format"الأسماء والعبارة عناصر نائبة، وليست بحثًا حقيقيًا أجريناه. استبدل المستودع الذي لديك إذن بمراجعته والصياغة ذات الصلة بسؤالك. إذا كنت تعرف أن الملفات تحت مسار توثيق، فأضف قيد path: مناسبًا؛ وإلا فاترك هذا الافتراض خارجًا.
فسّر التطابق قبل الاقتباس منه
| النتيجة | ما يجب التحقق منه | ما لا تثبته |
|---|---|---|
| اسم ملف مطابق | ما إذا كانت العبارة تظهر في المتن | أن الملف يدعم البيان |
| مقطع توثيق | الإصدار القريب وشروط الميزة | أن الميزة الموصوفة قد اختُبرت |
| مثال أو اقتراح | ما إذا كان يصف سلوكًا مخططًا أو توضيحيًا | أن الوظيفة قد صدرت |
| نتيجة فارغة | المستودع ونوع الاستعلام والقيود | أن الادعاء لم يوجد قط في أي مكان |
توثق GitHub شرط تسجيل الدخول لبحث الشفرة عبر جميع المستودعات العامة. كما تميّز بين موقع GitHub Pages ومحتوى مصدر المستودع. المصدر سجّل سطح البحث الفعلي وحدود الوصول؛ لا تتجاوز شرط تسجيل الدخول ولا تعتبر موقعًا غير مبحوث مشمولًا.
أبقِ المقطع مرتبطًا بإصدار
افتح الملف واقرأ القسم الكامل ذا الصلة. انسب الادعاء الموثق إلى المشروع. لا تنفذ شفرة المستودع لمجرد إكمال مهمة القراءة هذه، ولا تستنتج موثوقية المنتج من النجوم أو أسماء الحسابات.
بعد تحديد المقطع الصحيح، اتبع دليل الرابط الدائم في GitHub للاحتفاظ بالإصدار الذي فحصته. ثم تساعدك قائمة مراجعة المصادر للذكاء الاصطناعي على فصل بيان ذلك المستند عن الاستنتاجات التي أضافها النموذج.