أحد وثائق المواصفات التقنية — أو المواصفة — هو خريطة طريق لأي مشروع برمجيات، أجهزة، أو هندسة. إذا كان الإنجليزية ليست لغتك الأم، قد تشعر وكأنك تمشي على حبل مشدود عند كتابة واحدة منها. تحتاج إلى الدقة والوضوح وتدفق منطقي، مع استخدام مفردات قد لا تأتي لك بسهولة.
لقد رأيت فرقاً تضيع أسابيع لأن المواصفة كانت غامضة أو غير منظمة بشكل صحيح. الخبر السار؟ ليس عليك أن تكون متحدثًا أصليًا لكتابة مواصفة ممتازة. ما تحتاجه هو إطار عمل قوي وأدوات لغة مناسبة. دعني أريك كيف.
ما الذي يجعل المواصفة جيدة؟
قبل أن نتحدث عن اللغة، لنضع معيارًا واضحًا. تجيب المواصفة الجيدة على ثلاثة أسئلة:
- ما الذي نبنيه؟
- كيف سيعمل؟
- كيف نعرف أنه اكتمل؟
إذا غطيت هذه النقاط في مستندك، فأنت بالفعل متقدم على معظم الآخرين. الجزء الصعب هو القيام بذلك بدون الغموض. في كتابة المواصفات التقنية بالإنجليزية، كل كلمة لها وزن.
الهيكل الأساسي
إليك هيكل استخدمته وصقلته على مر سنوات من كتابة المواصفات. يعمل مع أي شيء بدءًا من نقطة نهاية API بسيطة إلى نظام متعدد الوحدات.
الهدف والنطاق
ما يفعله
كيف يعمل
اختبارات ومعايير
كل قسم له مهمة محددة. لا تخلط بينها. إذا تحدثت عن الاختبار داخل القسم الوظيفي، سيختلط على القارئ. احتفظ بالوضوح.
قسم النظرة العامة
أعلن الغرض في جملتين أو ثلاث. ثم اذكر:
- اسم المشروع والإصدار
- أصحاب المصلحة
- الاعتماديات
اجعلها مختصرة؛ لا أحد يقرأ نظرة عامة طويلة.
المتطلبات الوظيفية
هذا هو “ما”. اكتب كل متطلب كبيان مستقل. استخدم صيغة الفاعل النشطة.
❌ يجب أن يكون هناك زر تسجيل دخول على الصفحة.
✅ يقوم المستخدم بالنقر على “تسجيل الدخول” للوصول إلى لوحة التحكم الخاصة به.
لاحظ أن الجملة الثانية تخبرك بالعمل والنتيجة؛ هذا ما تحتاجه.
المتطلبات التقنية
هنا تصف البنية، تدفق البيانات، والقيود. هنا تصبح كتابة المواصفات التقنية أكثر تعقيدًا. كن محددًا بشأن أنواع البيانات والمدى والحدود.
مثال:
نقطة النهاية
/usersتُرجع مصفوفة JSON. يحتوي كل كائن علىid(عدد صحيح)،name(سلسلة، أقصى 100 حرف)، وcreated_at(تاريخ ISO 8601).
معايير القبول
كيف تعرف أن المواصفة مكتملة؟ اكتب بيانات قابلة للاختبار.
❌ يجب أن يتعامل النظام مع ملفات كبيرة.
✅ يعتمد النظام على ملفات حتى 50 ميغابايت بصيغ PNG أو JPEG. لا تتجاوز مدة التحميل 5 ثوانٍ على اتصال بسرعة 10 ميجابت/ثانية.
قواعد اللغة لكتابة المواصفات
الإنجليزية الخاصة بك ليست بحاجة إلى أن تكون فاخرة. في الواقع، البساطة أفضل. إليك ما يجب التركيز عليه.
استخدم “Shall” و“Must” بشكل صحيح
في المواصفات، shall تعني “هذا إلزامي.” Should تعني “مستحسن لكنه غير مطلوب.” May تعني “اختياري.”
- النظام shall يسجل جميع إجراءات المستخدم.
- الواجهة should تعرض رسائل الخطأ بالإنجليزية.
- يمكن للمستخدم أن يختار حفظ جلسته.
خلط هذه المصطلحات يسبب ارتباكًا. إذا كان شيء إلزاميًا، استخدم shall.
التفضيل للصيغة النشطة
الصيغة المبنية على الفاعل ليست خاطئة، لكنها أقل وضوحًا من الصيغة النشطة. قارن:
- مبني للمجهول: يتم معالجة البيانات بواسطة الخلفية.
- نشط: تقوم الخلفية بمعالجة البيانات.
الصيغة النشطة تخبرك بمن يفعل ماذا؛ في المواصفة هذا هو الذهب.
احتفظ ببنية الجملة بسيطة
الجمل القصيرة تقلل الأخطاء. اتبع النموذج التالي:
الفاعل + الفعل + المفعول به + الشرط
يعيد الخادم خطأ 404 عندما يطلب المستخدم معرفًا غير صالح.
يرسل وحدة البريد الإلكتروني رابط تأكيد بعد التسجيل.
لا تكتب جمل طويلة ومتداخلة. إذا تجاوزت الجملة 20 كلمة، فاقسمها.
الأخطاء الشائعة في كتابة المواصفات التقنية بالإنجليزية
لقد راجعت مئات المواصفات. هذه الثلاث أخطاء تظهر مرارًا وتكرارًا.
1. الضمائر الغامضة
“It” و“This” خطرة.
❌ يستدعي النظام API. يُرجع توكن.
ما الذي يُرجع التوكن؟ هل هو النظام أم الـAPI؟
✅ يستدعي النظام الـAPI. تُرجع الـAPI توكن.
2. المحددات غير الواضحة
كلمات مثل “some” و“several” لا تناسب المواصفة. استخدم أعدادًا دقيقة.
❌ يحتوي التقرير على عدة مخططات.
✅ يحتوي التقرير على ثلاثة مخططات على الأقل، بما في ذلك مخطط شريطي ومخطط خط.
3. خلط المتطلبات بالاقتراحات
لا تكتب “أعتقد أننا يجب أن” في المواصفة. إنها ليست نقاشًا. اكتب “النظام shall” أو “الفريق must.”
تمرين سريع للتدقيق الذاتي
قبل إرسال موافتك، اقرأها واسأل نفسك:
- هل يستطيع مطور تنفيذ هذا دون طرح أسئلة؟
- هل يمكن مختبر التحقق من كل بيان؟
- هل كل “shall” إلزامي حقًا، وكل “should” اختياري؟
إذا كان أي إجابة “لا”، أعد الكتابة.
أفكار أخيرة
كتابة مواصفة تقنية بالإنجليزية لا تتطلب قواعد نحوية مثالية. تحتاج إلى وضوح وتناسق وبنية توجه القارئ. التزم بالمخطط الذي شاركته، استخدم shall/must/should بدقة، واحتفظ بلغتك بسيطة. المواصفة الأفضل هي التي تترك مساحة للترجمة. احصل على ذلك، وستشكر فريقك.
هل ترغب في تحسين الإنجليزية لديك لكتابة فنية؟
اختبر مستواك الحالي مجانًا. نغطي القراءة والكتابة والاستماع والتحدث — مع تعليقات فعلية.
👉 ابدأ اختبار الإنجليزية المجاني
📝 قسم الممارسة ذات الصلة
ممارسة الكتابة: اطلع على قسم الممارسة للكتابة المدعوم بالذكاء الاصطناعي لتحسين مهاراتك في الكتابة والقواعد!
Ready to Take Your English Further?
Don't just read! Actively practice and improve your speaking, listening, reading, and writing skills with our interactive modules.