تعليقات مفيدة لكود موجود
تعليمات لكتابة تعليقات مفيدة ووصف للدوال في كود موجود دون تغيير المنطق أو الأسماء. انسخه إلى أداة ذكاء اصطناعي تختارها، وهي التي تعلّق على الكود.
- الموضوع
- فهم الشيفرة
- النوع
- موجّه
- المستوى
- مبتدئ
- الوقت
- نحو 5 د
تعتمد النتيجة على الأداة والنموذج وما تُدخله.
معاينة النتيجة
مثال: كتبه فريق التحرير لدينا، وليس مخرجات حقيقية للذكاء الاصطناعي.
def net_price(gross, rate): """يحوّل السعر الإجمالي إلى السعر الصافي. gross: السعر شاملًا الضريبة، كعدد عشري. rate: نسبة الضريبة ككسر، مثل 0.15. يُرجع السعر الصافي مقرّبًا إلى منزلتين. """ # التقريب في النهاية فقط حتى لا تتراكم أخطاء التقريب. return round(gross / (1 + rate), 2) للتحقق: ماذا يحدث إذا كانت rate = -1؟
التعبئة
ما تكتبه يبقى في نافذة المتصفح هذه. نحن لا نحفظ شيئًا ولا نرسله.
- Python
- TypeScript
- Java
- PHP
- Go
- أعضاء الفريق الجدد
- أنا بعد ستة أشهر
- مساهمون خارجيون
- طلاب
- فريق الصيانة
موجّهك
لقد عدّلت الموجّه. لن تستبدله التغييرات في الحقول أعلاه بعد الآن.
هذا توجيه لأداة ذكاء اصطناعي، وليس النتيجة بعد.
أين يعمل هذا الموجّه
أدوات الذكاء الاصطناعي هذه مناسبة لهذا الموجّه:
طريقة الاستخدام
- املأ الحقول أو اضغط على أحد الاقتراحات. لا تكتب الأسماء أو العناوين أو أي بيانات شخصية أخرى.
- انسخ الموجّه الجاهز إلى أداة الذكاء الاصطناعي التي تفضّلها.
- راجع التعليقات وحلّ نقاط التحقق قبل اعتمادها.
لماذا ينجح هذا؟
التعليقات التي تشرح السبب تبقى مفيدة بعد التغييرات. وقاعدة عدم تغيير المنطق تُبقي التعديل صغيرًا وسهل المراجعة.
نصائح
- احذف قبل اللصق القيم الحساسة مثل المفاتيح وكلمات المرور أو استبدلها بخانات فارغة.