دليل ترجمة المحتوى العربي

لماذا تقابل كلمات إنجليزية داخل الدروس؟

وأنت تقرأ درسًا بالعربية ستمرّ بجمل مثل: «ضع الملف كاملًا في الـContext»، أو «افتح Pull Request بعد أن تنتهي». هذا ليس كسلًا في الترجمة، بل قرار تعليمي.

في عمل البرمجة الحقيقي هذه الكلمات لا تُترجم: التوثيق الرسمي بالإنجليزية، ورسائل الأخطاء بالإنجليزية، والمهندسون الذين ستعمل معهم يقولون «Pull Request» لا «طلب سحب». لو تعلّمتَ المصطلح بترجمة عربية مخترعة فستحتاج أن تتعلّمه مرة ثانية أول ما تفتح صفحة توثيق أو تبحث عن خطأ على الإنترنت.

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

• قراءة التوثيق الرسمي للأدوات التي تستخدمها.
• البحث عن رسالة الخطأ الحقيقية كما تظهر لك، والعثور على الإجابة.
• الحديث مع مهندسين من أي مكان بالمصطلحات نفسها التي يستخدمونها.

الشرح والتفكير والأمثلة كلها بالعربية. المصطلح وحده هو ما يبقى بالإنجليزية.

بقية هذه الصفحة هي القواعد الكاملة التي نكتب بها المحتوى، وقائمة المصطلحات التي قررنا إبقاءها بالإنجليزية.

القواعد

استخدم هذه القواعد عند كتابة أو ترجمة أو مراجعة أي نص عربي في الدورات: نظرة الدورة العامة، ومخرجات التعلّم، وعناوين الوحدات والدروس، ونصوص الدروس، والاختبارات، والترجمات النصية للفيديو. تنطبق على الكاتب والمراجع وأي Coding Agent يكتب أو يترجم محتوى الدورات.

الهدف

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

النبرة

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

قواعد المصطلحات

• أبقِ المصطلح التقني أو العلمي بالإنجليزية عندما لا يكون له مقابل عربي طبيعي وواسع الانتشار. لا تخترع ترجمة قسرية أبدًا.
• اكتب المصطلح الإنجليزي طبيعيًا داخل الجملة العربية، مع أداة التعريف العربية عندما تساعد: الـContext، الـTokens، الـModel، الـLLM، الـAgent.
• أبقِ أسماء المنتجات، والأوامر، وأسماء الملفات، والاختصارات، والمعرّفات كما هي بالضبط: Git، MCP، Superpowers، AGENTS.md، CLAUDE.md.
• أبقِ هذه المصطلحات الهندسية بالإنجليزية: Issue، Pull Request، Acceptance Criteria، Coding Agent، Context Window، LLM، Tokens.
• استخدم الكود للتعبير عن code، ولا تستخدم الشيفرة أبدًا. استخدم تيكت للتعبير عن Issue في سياق الكلام.
• المصطلح الذي أُبقي بالإنجليزية يُكتب بالطريقة نفسها في الدورة كلها: لا الـContext في درس و«السياق» في درس آخر.

الصياغة المفضّلة

المصطلحات التي نُبقيها بالإنجليزية

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

قائمة المراجعة قبل النشر

قبل نشر أي نص عربي في الدورة، تحقّق من أن:

1. النقطة التعليمية والنطاق يطابقان المصدر الإنجليزي.
2. المصطلحات المُبقاة بالإنجليزية متسقة في الدورة كلها.
3. كل استخدام لكلمة code مكتوب الكود.
4. أسماء المنتجات، والأوامر، وأسماء الملفات، والاختصارات لم تتغيّر.
5. يستطيع المتعلّم متابعة النص دون ترجمة حرفية لكل مصطلح تقني.
6. النصان العربي والإنجليزي موجودان معًا في سجل محتوى الدورة.

سجل تغييرات تفضيلات الترجمة

هذا السجل يحفظ قرارات مالك المحتوى. عندما يطلب تغيير ترجمة أو صياغة، أضف القرار إلى هذا الجدول وعدّل جدول الصياغة المفضّلة أو سجل المصطلحات أعلاه عند الحاجة. لا تعِد اتخاذ قرار مسجّل من البداية.