Skip to content

Commit

Permalink
fix typos in Arabic translation & review some sentences (gaearon#587)
Browse files Browse the repository at this point in the history
  • Loading branch information
atefBB authored and gaearon committed Jan 28, 2020
1 parent e45a2b3 commit a349d20
Showing 1 changed file with 8 additions and 8 deletions.
16 changes: 8 additions & 8 deletions src/pages/optimized-for-change/index.ar.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,19 +6,19 @@ spoiler: ما الذي يجعل واجهة برمجية رائعة؟

ما الذي يجعل واجهة برمجية رائعة؟

تصميم واجهة برمجية *جيدة* يعني ان تكون بارزة و غير مبهمة. أن تشجع على سهولة قرائة وتطوير وتسحين الكود وكذلك مساعدة المطورين في الوقوع في [حفرة النجاح](https://blog.codinghorror.com/falling-into-the-pit-of-success/).
تصميم واجهة برمجية *جيدة* يعني أن تكون بارزة وغير مبهمة. أن تشجع على سهولة قراءة وتطوير وتسحين الشفرة، وكذلك مساعدة المطورين في الوقوع في [حفرة النجاح](https://blog.codinghorror.com/falling-into-the-pit-of-success/).

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


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

أفضل مصممي الواجهات البرمجية الذين أعرفهم لايتوقفون عن جوانب "الترتيب الأول" مثل قابلية القراءة. يكرسون قدرًا كبيرًا من الجهد ، إن لم يكن أكثر ، لما أسميه تصميم واجهة برمجية "من المرتبة الثانية":**كيف سيتم بمرور الوقت تطوير الكود باستخدام هذه الواجهة البرمجية**.
أفضل مصممي الواجهات البرمجية الذين أعرفهم لا يتوقفون عند جوانب "الترتيب الأول" مثل قابلية القراءة. فهم يكرسون قدرًا كبيرًا من الجهد، إن لم يكن أكثر، لما أسميه تصميم واجهة برمجية "من المرتبة الثانية": **كيف سيتم بمرور الوقت تطوير الشفرة باستخدام هذه الواجهة البرمجية**.

يمكن أن يؤدي التغيير الطفيف في المتطلبات إلى تفكك الكود الأكثر اناقة.
يمكن أن يؤدي التغيير الطفيف في المتطلبات إلى تفكك الشفرة الأكثر أناقة.

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

لا تتيح لك الواجهات البرمجية (APIs) الرائعة الوقوع في حفرة النجاح فحسب ، بل تساعدك أيضًا على *البقاء* هناك.
لا تتيح لك الواجهات البرمجية (APIs) الرائعة الوقوع في حفرة النجاح فحسب، بل تساعدك أيضًا على *البقاء* هناك.

هي محسنه للتغيير
هي محسنة للتغيير.

0 comments on commit a349d20

Please sign in to comment.