Skip to content

WIP: Translate "Introducing Concurrent Mode" #207

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 18 additions & 18 deletions content/docs/concurrent-mode-intro.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
id: concurrent-mode-intro
title: Introducing Concurrent Mode (Experimental)
title: "تجريبي: مدخل إلى الوضع المتزامن (Concurent mode)"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"أعتقد ان استخدام كلمة "مقدمة" أفضل من "مدخل

permalink: docs/concurrent-mode-intro.html
next: concurrent-mode-suspense.html
---
Expand All @@ -14,38 +14,38 @@ next: concurrent-mode-suspense.html

<div class="scary">

>Caution:
>احذر:
>
>This page describes **experimental features that are [not yet available](/docs/concurrent-mode-adoption.html) in a stable release**. Don't rely on experimental builds of React in production apps. These features may change significantly and without a warning before they become a part of React.
>تتناول هذه الصفحة **ميزات تجريبية [والتي ليست متوفّرة بعد](/docs/concurrent-mode-adoption.html) في في أيّ من الاصدارات المستقرّة**. ﻻ تعتمد على بُنيات تجريبية من React في تطبيقاتك الموجهة للإنتاج (Production apps). قد تواجه هذه المميزات تغييرات جذرية دون أي تحذير قبل أن تصبح جزءًا من React.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

احذف "في" الزائدة.

>
>This documentation is aimed at early adopters and people who are curious. **If you're new to React, don't worry about these features** -- you don't need to learn them right now.
>هذا المستند موجّه للفضوليين ولمن يريد تجربة الممزات الجديدة. **إن كنت مبتدأ في React ﻻ تقلق بشأن هذه الميزات** -- ﻻ تحتاج إلى تعلّمها في الوقت الحالي.

</div>

This page provides a theoretical overview of Concurrent Mode. **For a more practical introduction, you might want to check out the next sections:**
توفّر هذه الصفحة لمحة نظرية عن الوضع المتزامن (Concurent Mode) **إن كنت تريد مقّدمة عمليّة، يجدر بك الإطلاع على:**

* [Suspense for Data Fetching](/docs/concurrent-mode-suspense.html) describes a new mechanism for fetching data in React components.
* [Concurrent UI Patterns](/docs/concurrent-mode-patterns.html) shows some UI patterns made possible by Concurrent Mode and Suspense.
* [Adopting Concurrent Mode](/docs/concurrent-mode-adoption.html) explains how you can try Concurrent Mode in your project.
* [Concurrent Mode API Reference](/docs/concurrent-mode-reference.html) documents the new APIs available in experimental builds.
* [استعمال Suspense لجلب البيانات](/docs/concurrent-mode-suspense.html) تشرح آلية جديدة لجلب البيانات في مكوّنات React.
* [أنماط واجهات المستخدم المتزامنة (Concurrent UI Patterns)](/docs/concurrent-mode-patterns.html) تعرض بعض أنماط واجهات المستخدم أين يستعمل فيها الوضع المتزامن و Suspense.
* [تبنّي الوضع المتزامن](/docs/concurrent-mode-adoption.html) تشرح كيفية استعمال الوضع المتزامن في مشروعك.
* [واجهة الوضع المتزامن البرمجية (API reference)](/docs/concurrent-mode-reference.html) توثّق الواجهات البرمجية المستعملة في البنى التجربية.

## What Is Concurrent Mode? {#what-is-concurrent-mode}
## ماهو الوضع المتزامن? {#what-is-concurrent-mode}

Concurrent Mode is a set of new features that help React apps stay responsive and gracefully adjust to the user's device capabilities and network speed.
الوضع المتزامن هو مجموعة من الميزات التي تجعل من تطبيقات React متجاوبة ومتأقلمة مع إمكانيات جهاز المستخدم ونوعيّة (سرعة) اتصاله بالشبكة.

These features are still experimental and are subject to change. They are not yet a part of a stable React release, but you can try them in an experimental build.
هذه الميزات ﻻ زالت تجريبية وقابلة للتغيير. ولذلك ليست جزءًا من إصدارات React المستقرّة.

## Blocking vs Interruptible Rendering {#blocking-vs-interruptible-rendering}
## التصصير الإعتراضي (Blocking) والتصيير القابل للمقاطعة (Interruptible) {#blocking-vs-interruptible-rendering}

**To explain Concurrent Mode, we'll use version control as a metaphor.** If you work on a team, you probably use a version control system like Git and work on branches. When a branch is ready, you can merge your work into master so that other people can pull it.
**سنستعمل إدارة الإصدارات كمثال لشرح الوضع المتزامن.** عند العمل في فريق، على الأغلب ستستعملون برنامج إدارة النسخ مثل Git وستعملون على فروع (branches). يمكنك دمج الفرع عندما يصبح جاهزا مع الفرع الرئيسي master حتى يسحبه الآخرون.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

الكاف في اللغة العربية لا تكون إلا للتشبيه والسياق ليس سياق تشبيه بل سياق توصيف، لذلك اقترح استعمال المصدر فتصبح الجملة: "سنستعمل إدارة اﻹصدارات مثالا لشرح ...".


Before version control existed, the development workflow was very different. There was no concept of branches. If you wanted to edit some files, you had to tell everyone not to touch those files until you've finished your work. You couldn't even start working on them concurrently with that person — you were literally *blocked* by them.
كان مسار التطوير مختلفا جدا قبل نشأءة نظم إدارة النسخ، لم يكن هناك أي مفهوم للفروع. إن كنت تريد تعديل بعض الملفات، عليك أن تخبر الجميع بألا يلمسوها حتى تنهي عملك. ﻻ يمكنك حتى أن تبدأ في العمل عليها بالتزامن مع الشخص الذي *يعترضك* حرفيّا.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"نشأة" بهمزة واحدة على اﻷلف.


This illustrates how UI libraries, including React, typically work today. Once they start rendering an update, including creating new DOM nodes and running the code inside components, they can't interrupt this work. We'll call this approach "blocking rendering".
هذا ما يوضّح طريقة عمل مكتبات واجهات المستخدم بما فيها React. لمّا تشرع في تصصير تحديث ينجم عنه إنشاء عقد DOM وتشغيل الشيفرة داخل المكوّن، ﻻ يمكن مقاطعتها أثناء ذلك. سنسمّي هذا المفهوم "التصيير الإعتراضي".
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

اقترح التعديل التالي: "عند الشروع في تصيير ...".


In Concurrent Mode, rendering is not blocking. It is interruptible. This improves the user experience. It also unlocks new features that weren't possible before. Before we look at concrete examples in the [next](/docs/concurrent-mode-suspense.html) [chapters](/docs/concurrent-mode-patterns.html), we'll do a high-level overview of new features.
في الوضع المتزامن، التصيير ليس إعتراضيا بل هو قابل للمقاطعة. هذا سيحسّن تجربة المستخدم. وسيفتح الباب لمزيد من الميزات التي لم تكن ممكنة من قبل. قبل أن ننظر إلى أمثلة حقيقيّة في [الفقرات](/docs/concurrent-mode-suspense.html) [القادمة](/docs/concurrent-mode-patterns.html)، سنلقي نظرة سطحيّة على الميزات الجديدة.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"إعتراضيا" بهمزة وصل "اعتراضيا".


### Interruptible Rendering {#interruptible-rendering}
### التصيير القابل للمقاطعة {#interruptible-rendering}

Consider a filterable product list. Have you ever typed into a list filter and felt that it stutters on every key press? Some of the work to update the product list might be unavoidable, such as creating new DOM nodes or the browser performing layout. However, *when* and *how* we perform that work plays a big role.

Expand Down