From 2f4019b1ddf7b7563b4847741f460cfdb0a4e662 Mon Sep 17 00:00:00 2001 From: Mostafa Ewis <64862002+MostafaEwis@users.noreply.github.com> Date: Mon, 6 Feb 2023 09:18:38 +0200 Subject: [PATCH 1/8] created the translation folder, the Ar readme file and translated the first paragraph MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit I made the Ar folder and the readme file and tried to make it look like the other translation attempts I translated the first paragraph until now A lot of the terminology has no formal translation in Arabic so I tried to find equivalents in Wikipedia and when no equivalent showed I tried to search in Hsoub as they teach programming in Arabic and made some terminology popular and when I found no equivalent in both of these sites I tried to come up with a translation like "pull request" I translated it to "طلب سحب" and in the first mention of the word I wrote PR next to it as an hint for the Arabic user and did the same for the words "issue" and "repository". --- contributor_docs/ar/README.md | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 contributor_docs/ar/README.md diff --git a/contributor_docs/ar/README.md b/contributor_docs/ar/README.md new file mode 100644 index 0000000000..ae5f897f0d --- /dev/null +++ b/contributor_docs/ar/README.md @@ -0,0 +1,8 @@ +# 🌸مرحبا 🌺 +شكرا لإهتمامك بالمساهمة في p5.js! مجتمعنا يقدر المساهمات في كل أشكالها ويسعى إلى توسيع معنى كلمة "مساهم" بأقصى شكل ممكن؛ بشكل يتضمن توثيق البرمجيات، التدريس، كتابة الشفرة البرمجية، صناعة الفن، الكتابة، التصميم، النشاطية، التنظيم، نَظْم المحتوى أو أي شيء أخر يمكن أن تتخيله. [صفحة المجتمع خاصتنا](https://p5js.org/community/#contribute) تعطي ملخصا للطرق المختلفة التي يمكن بها أن تشارك وتساهم معنا. + +هذا المشروع يتبع مواصفات مشروع [all-contributors "كل المساهمين"](https://github.com/kentcdodds/all-contributors). نحن نستعمل البوت @all-contributors كي نضيف المساهمين إلى الملف README.md. يمكنك أن تطلب من البوت @all-contributors أن يضيفك عن طريق كتابة الآتي في تعليق على مشكلة على جيت هب أو طلب سحب PR: +``` +@all-contributors please add @[اسم المسخدم خاصتك على جيت هب] for [نوع مساهمتك] +``` +يمكنك أن تعرف نوع مساهمتك الشائع من [هنا](https://allcontributors.org/docs/en/emoji-key)، على الرغم من أننا غالبا سنضيفك بشكل تلقائي إلى قائمة المساهمين بعد قبول طلب السحب خاصتك. دليل المساهمين منشور على [موقع](https://p5js.org/contributor-docs/#/) p5.js ومستضاف على[ مستودع "repository" جيت هب](https://github.com/processing/p5.js/tree/main/contributor_docs) الخاص بـ p5.js. \ No newline at end of file From 0f400583ab8233304c5ef9c43a8f372009e92511 Mon Sep 17 00:00:00 2001 From: Mostafa Ewis <64862002+MostafaEwis@users.noreply.github.com> Date: Wed, 8 Feb 2023 00:25:41 +0200 Subject: [PATCH 2/8] translation of the second paragraph MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit I translated the second paragraph for the word familiar in at the end of the paragraph I used two words for translation which are: "تألف" ,"تفهم" I used these words instead of the equivalent word for familiar which is "تعتاد" as the words I used gives the meaning intended more than the word "تعتاد". The words "accessibility" and "inclusion" were translated to the words "إمكانية الوصول والإتاحة" and "حقوق المعاقين" The word "accessibility" has wo equivalents which are "إمكانية الوصول والإتاحة" but every word of these is has a distinct meaning but both used will give the meaning intended. For the word " inclusion" there is no direct equivalent for it in Arabic, so I tried to search it in Wikipedia and found out that it also means "disability rights" so I translated it to Arabic to "حقوق المعاقين". The word disabled has two equivalents in Arabic which are "المعاقين", "المعوقين" but "المعاقين " is the most used and uniformed word for this word so I used it. --- .eslintrc.json | 2 +- contributor_docs/ar/README.md | 9 ++++++++- 2 files changed, 9 insertions(+), 2 deletions(-) diff --git a/.eslintrc.json b/.eslintrc.json index 06589c1db7..10e1b85aa1 100644 --- a/.eslintrc.json +++ b/.eslintrc.json @@ -46,7 +46,7 @@ "comma-dangle": ["error", "never"], "object-curly-spacing": ["error", "always"], "arrow-parens": ["error", "as-needed"], - "linebreak-style": ["error", "unix"], + "linebreak-style": ["error", "windows"], "no-trailing-spaces": ["error"], "no-prototype-builtins": "off", "no-async-promise-executor": "off" diff --git a/contributor_docs/ar/README.md b/contributor_docs/ar/README.md index ae5f897f0d..085a156aee 100644 --- a/contributor_docs/ar/README.md +++ b/contributor_docs/ar/README.md @@ -5,4 +5,11 @@ ``` @all-contributors please add @[اسم المسخدم خاصتك على جيت هب] for [نوع مساهمتك] ``` -يمكنك أن تعرف نوع مساهمتك الشائع من [هنا](https://allcontributors.org/docs/en/emoji-key)، على الرغم من أننا غالبا سنضيفك بشكل تلقائي إلى قائمة المساهمين بعد قبول طلب السحب خاصتك. دليل المساهمين منشور على [موقع](https://p5js.org/contributor-docs/#/) p5.js ومستضاف على[ مستودع "repository" جيت هب](https://github.com/processing/p5.js/tree/main/contributor_docs) الخاص بـ p5.js. \ No newline at end of file +يمكنك أن تعرف نوع مساهمتك الشائع من [هنا](https://allcontributors.org/docs/en/emoji-key)، على الرغم من أننا غالبا سنضيفك بشكل تلقائي إلى قائمة المساهمين بعد قبول طلب السحب خاصتك. دليل المساهمين منشور على [موقع](https://p5js.org/contributor-docs/#/) p5.js ومستضاف على[ مستودع "repository" جيت هب](https://github.com/processing/p5.js/tree/main/contributor_docs) الخاص بـ p5.js. + +# قبل أن تساهم معنا +المساهمة في مشروع p5.js يجب أن تكون تجربة خالية من أي ضغط، فنحن نرحب بكل المساهمات بغض النظر عن حجمها، سواء قد قمت بإصلاح خطأ مطبعي بسيط أو أعدت هيكلة الآليات المعقدة لعرض الرسوم ثلاثية الأبعاد، لكن توجد بعض الأشياء التي يجب أن تألفها وتفهمها قبل أن تبدأ في المساهمة. + +بدايةً: من فضلك قم بقراءة [بيان مجتمعنا](https://p5js.org/community/) + +أما بعد: نحن حاليا نعطي الأولوية للأعمال التي تُزيد الوصول (إمكانية الوصول والإتاحة وحقوق المعاقين) لـ p5.js! للمزيد من التفاصيل، فلتلق نظرة على [بيان الإتاحة خاصتنا](./access.md) \ No newline at end of file From 66f497cd9caabd7eb8042207218975e9288f8ac7 Mon Sep 17 00:00:00 2001 From: Mostafa Ewis <64862002+MostafaEwis@users.noreply.github.com> Date: Wed, 8 Feb 2023 00:26:07 +0200 Subject: [PATCH 3/8] Revert "translation of the second paragraph" This reverts commit 0f400583ab8233304c5ef9c43a8f372009e92511. --- .eslintrc.json | 2 +- contributor_docs/ar/README.md | 9 +-------- 2 files changed, 2 insertions(+), 9 deletions(-) diff --git a/.eslintrc.json b/.eslintrc.json index 10e1b85aa1..06589c1db7 100644 --- a/.eslintrc.json +++ b/.eslintrc.json @@ -46,7 +46,7 @@ "comma-dangle": ["error", "never"], "object-curly-spacing": ["error", "always"], "arrow-parens": ["error", "as-needed"], - "linebreak-style": ["error", "windows"], + "linebreak-style": ["error", "unix"], "no-trailing-spaces": ["error"], "no-prototype-builtins": "off", "no-async-promise-executor": "off" diff --git a/contributor_docs/ar/README.md b/contributor_docs/ar/README.md index 085a156aee..ae5f897f0d 100644 --- a/contributor_docs/ar/README.md +++ b/contributor_docs/ar/README.md @@ -5,11 +5,4 @@ ``` @all-contributors please add @[اسم المسخدم خاصتك على جيت هب] for [نوع مساهمتك] ``` -يمكنك أن تعرف نوع مساهمتك الشائع من [هنا](https://allcontributors.org/docs/en/emoji-key)، على الرغم من أننا غالبا سنضيفك بشكل تلقائي إلى قائمة المساهمين بعد قبول طلب السحب خاصتك. دليل المساهمين منشور على [موقع](https://p5js.org/contributor-docs/#/) p5.js ومستضاف على[ مستودع "repository" جيت هب](https://github.com/processing/p5.js/tree/main/contributor_docs) الخاص بـ p5.js. - -# قبل أن تساهم معنا -المساهمة في مشروع p5.js يجب أن تكون تجربة خالية من أي ضغط، فنحن نرحب بكل المساهمات بغض النظر عن حجمها، سواء قد قمت بإصلاح خطأ مطبعي بسيط أو أعدت هيكلة الآليات المعقدة لعرض الرسوم ثلاثية الأبعاد، لكن توجد بعض الأشياء التي يجب أن تألفها وتفهمها قبل أن تبدأ في المساهمة. - -بدايةً: من فضلك قم بقراءة [بيان مجتمعنا](https://p5js.org/community/) - -أما بعد: نحن حاليا نعطي الأولوية للأعمال التي تُزيد الوصول (إمكانية الوصول والإتاحة وحقوق المعاقين) لـ p5.js! للمزيد من التفاصيل، فلتلق نظرة على [بيان الإتاحة خاصتنا](./access.md) \ No newline at end of file +يمكنك أن تعرف نوع مساهمتك الشائع من [هنا](https://allcontributors.org/docs/en/emoji-key)، على الرغم من أننا غالبا سنضيفك بشكل تلقائي إلى قائمة المساهمين بعد قبول طلب السحب خاصتك. دليل المساهمين منشور على [موقع](https://p5js.org/contributor-docs/#/) p5.js ومستضاف على[ مستودع "repository" جيت هب](https://github.com/processing/p5.js/tree/main/contributor_docs) الخاص بـ p5.js. \ No newline at end of file From 1c9c2adf0072cf1d33a22ea8ad783fc4d052a59f Mon Sep 17 00:00:00 2001 From: Mostafa Ewis <64862002+MostafaEwis@users.noreply.github.com> Date: Wed, 8 Feb 2023 00:29:59 +0200 Subject: [PATCH 4/8] translation of the second paragraph MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit I translated the second paragraph for the word familiar in at the end of the paragraph I used two words for translation which are: "تألف" ,"تفهم" I used these words instead of the equivalent word for familiar which is "تعتاد" as the words I used gives the meaning intended more than the word "تعتاد". The words "accessibility" and "inclusion" were translated to the words "إمكانية الوصول والإتاحة" and "حقوق المعاقين" The word "accessibility" has wo equivalents which are "إمكانية الوصول والإتاحة" but every word of these is has a distinct meaning but both used will give the meaning intended. For the word " inclusion" there is no direct equivalent for it in Arabic, so I tried to search it in Wikipedia and found out that it also means "disability rights" so I translated it to Arabic to "حقوق المعاقين". The word disabled has two equivalents in Arabic which are "المعاقين", "المعوقين" but "المعاقين " is the most used and uniformed word for this word so I used it. --- contributor_docs/ar/README.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/contributor_docs/ar/README.md b/contributor_docs/ar/README.md index ae5f897f0d..085a156aee 100644 --- a/contributor_docs/ar/README.md +++ b/contributor_docs/ar/README.md @@ -5,4 +5,11 @@ ``` @all-contributors please add @[اسم المسخدم خاصتك على جيت هب] for [نوع مساهمتك] ``` -يمكنك أن تعرف نوع مساهمتك الشائع من [هنا](https://allcontributors.org/docs/en/emoji-key)، على الرغم من أننا غالبا سنضيفك بشكل تلقائي إلى قائمة المساهمين بعد قبول طلب السحب خاصتك. دليل المساهمين منشور على [موقع](https://p5js.org/contributor-docs/#/) p5.js ومستضاف على[ مستودع "repository" جيت هب](https://github.com/processing/p5.js/tree/main/contributor_docs) الخاص بـ p5.js. \ No newline at end of file +يمكنك أن تعرف نوع مساهمتك الشائع من [هنا](https://allcontributors.org/docs/en/emoji-key)، على الرغم من أننا غالبا سنضيفك بشكل تلقائي إلى قائمة المساهمين بعد قبول طلب السحب خاصتك. دليل المساهمين منشور على [موقع](https://p5js.org/contributor-docs/#/) p5.js ومستضاف على[ مستودع "repository" جيت هب](https://github.com/processing/p5.js/tree/main/contributor_docs) الخاص بـ p5.js. + +# قبل أن تساهم معنا +المساهمة في مشروع p5.js يجب أن تكون تجربة خالية من أي ضغط، فنحن نرحب بكل المساهمات بغض النظر عن حجمها، سواء قد قمت بإصلاح خطأ مطبعي بسيط أو أعدت هيكلة الآليات المعقدة لعرض الرسوم ثلاثية الأبعاد، لكن توجد بعض الأشياء التي يجب أن تألفها وتفهمها قبل أن تبدأ في المساهمة. + +بدايةً: من فضلك قم بقراءة [بيان مجتمعنا](https://p5js.org/community/) + +أما بعد: نحن حاليا نعطي الأولوية للأعمال التي تُزيد الوصول (إمكانية الوصول والإتاحة وحقوق المعاقين) لـ p5.js! للمزيد من التفاصيل، فلتلق نظرة على [بيان الإتاحة خاصتنا](./access.md) \ No newline at end of file From 83b80196876583d9493f75af6c6fd73e5c3bc0b8 Mon Sep 17 00:00:00 2001 From: Mostafa Ewis <64862002+MostafaEwis@users.noreply.github.com> Date: Sun, 12 Feb 2023 13:53:55 +0200 Subject: [PATCH 5/8] Translation of the last paragraph Finished the translation, but this is not the final form, I'm still searching for appropriate terms for some words in the terminology, also some additional revision on the text will be done to make it perfect and make sure that there are no typos or wrong grammar. There are a bug that occurred while writing this which is that the lists written in Arabic, have the list content in LTR while the list numbers/bullets are in RTL, I couldn't find a solution for this bug, but I'm still searching for a solution. --- contributor_docs/ar/README.md | 36 ++++++++++++++++++++++++++++++++++- 1 file changed, 35 insertions(+), 1 deletion(-) diff --git a/contributor_docs/ar/README.md b/contributor_docs/ar/README.md index 085a156aee..92c5034f06 100644 --- a/contributor_docs/ar/README.md +++ b/contributor_docs/ar/README.md @@ -12,4 +12,38 @@ بدايةً: من فضلك قم بقراءة [بيان مجتمعنا](https://p5js.org/community/) -أما بعد: نحن حاليا نعطي الأولوية للأعمال التي تُزيد الوصول (إمكانية الوصول والإتاحة وحقوق المعاقين) لـ p5.js! للمزيد من التفاصيل، فلتلق نظرة على [بيان الإتاحة خاصتنا](./access.md) \ No newline at end of file +أما بعد: نحن حاليا نعطي الأولوية للأعمال التي تُزيد الوصول (إمكانية الوصول والإتاحة وحقوق المعاقين) لـ p5.js! للمزيد من التفاصيل، فلتلق نظرة على [بيان الإتاحة خاصتنا](./access.md) + +# ابدأ + +الأن أنت مستعد لتبدأ المساهمة في p5.js! هناك العديد من الطرق لتبدأ المساهمة إلى p5.js وأيضا العديد من الأسباب لتساهم معنا. في سياق هذا الدليل، سنقسم المساهمات بشكل عام إلى قسمين: + +- المساهمات التي تتعامل بشكل مباشر مع الشفرة المصدرية (هذا يتضمن التوثيق البرمجي) +- المساهمات التي قلما تتعامل مع الشفرة المصدرية أو لا تتعامل مها على الإطلاق + + +على حسب نوع المساهمة التي ستقوم بها إلى p5.js، من فضلك قم بقراءة الجزء المناسب من هذا الدليل. + +## [المساهمات إلى الشفرة المصدرية](./contributor_guidelines.md) +لتقوم بمساهمة مثالية إلى مستودع p5.js أو موقع p5.js، قم بإتباع الخطوات الآتية: +1. قم بعمل مشكلة على جيت هب +2. ناقش هذه المشكلة +3. الحصول على موافقة للتقدم بطلب سحب (PR) +4. غير الشفرة المصدرية +5. قم بطلب سحب +6. ناقش طلب السحب +7. الموافقة على طلبك وضمه + +تصفح هذه[ الصفحة](./contributor_guidelines.md)، حيث سيتم توجهيك خطوة بخطوة لتنفذ الخطوات المذكورة أعلاه، يمكنك أن تستعمل فهرس الصفحة المذكورة لتصل إلى الأجزاء التي تريد مراجعتها أو تذكرها. + +معظم الوقت سنسير بحزم على خطة العمل هذه، قد تشعر بأننا نقوم بالكثير من المناورات من أجل ما يبدو مساهمة بسيطة، وبخاصة إذا قد قمت بالمساهمة في مشاريع أخرى. رغم ذلك، فإننا نهدف بالخطوات المذكورة أعلاه بأن نسهل عليك كمساهم أو كمتعهد/مشرف المساهمة بشكل هادف ذو معنى، وفي نفس الوقت نحرص على ألا تضيع وقتك في عمل قد يُرفض لأسباب كثيرة. الخطوات أعلاه تساعد في أن نضمن أن كل اقتراح أو إصلاح قد نوقش بشكل وافٍ قبل البدأ في تنفيذه، مما سيوفر عليك (والمتعهدين والمشرفين) الوقتن، حيث ستقل طلبات السحب التي تتطلب المزيد من التعديلات بعد مراجعتها، أو الإصلاحات المرفوضة من البداية بشكل صريح. + +**نحن نرى المساهمة إلى p5.js كفرصة للتعلم** ولا نقيس النجاح بعدد المساهمات التي تصلنا. لا توجد مهلة تَحدُك حتى تنفذ مساهمتك، لذا خذ وقتك وأعمل بسرعة تناسبك (قد نراسلك إذا غبت لفترة طويلة). يمكنك سؤال المتعهدين أو المشرفين إذا احتجتهم وسوف نبذل قصاري جهدنا حتى نساعدك. + +## المساهمات إلى غير الشفرة المصدرية +هناك العديد من الطرق كي تساهم إلى p5.js بعيدا عن الشفرة المصدرية، أكثر حتى من أن نحصيها هنا، بعض الطرق قد تتضمن العمل مع مستودع p5.js (كإضافة الأمثلة، أو كتابة درس للموقع، إلخ). على حسب المساهمة المخطط لها، قد نكون قادرين على مساعدتك بطرق عدة، لذا تواصل معنا عبر أي قناة من قنوات التواصل المتاحة لك (البريد الإلكتروني، وسائل التواصل الإجتماعي، منتدى النقاش، ديسكورد، إلخ). + +## [المتعهدين والمشرفين](./steward_guidelines.md) + +للدليل الخاص بالمتعهدين أو الصيانة العامة لمستودع p5.js على جيت هب، من فضلك ألق نظرة على [دليل المتعهدين](./steward_guidelines.md) + From d059e04371bf9cec7736d5733b5043a7b4529e61 Mon Sep 17 00:00:00 2001 From: Mostafa Ewis <64862002+MostafaEwis@users.noreply.github.com> Date: Mon, 13 Feb 2023 13:52:32 +0200 Subject: [PATCH 6/8] Fixed the lists showing in LTR in VSCode This should make no difference to how the readme looks on GitHub, but it changed the lists behavior in VSCode to show in RTL as intended. --- contributor_docs/ar/README.md | 23 +++++++++++++---------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/contributor_docs/ar/README.md b/contributor_docs/ar/README.md index 92c5034f06..d6141abeb2 100644 --- a/contributor_docs/ar/README.md +++ b/contributor_docs/ar/README.md @@ -18,21 +18,24 @@ الأن أنت مستعد لتبدأ المساهمة في p5.js! هناك العديد من الطرق لتبدأ المساهمة إلى p5.js وأيضا العديد من الأسباب لتساهم معنا. في سياق هذا الدليل، سنقسم المساهمات بشكل عام إلى قسمين: -- المساهمات التي تتعامل بشكل مباشر مع الشفرة المصدرية (هذا يتضمن التوثيق البرمجي) -- المساهمات التي قلما تتعامل مع الشفرة المصدرية أو لا تتعامل مها على الإطلاق - + على حسب نوع المساهمة التي ستقوم بها إلى p5.js، من فضلك قم بقراءة الجزء المناسب من هذا الدليل. ## [المساهمات إلى الشفرة المصدرية](./contributor_guidelines.md) لتقوم بمساهمة مثالية إلى مستودع p5.js أو موقع p5.js، قم بإتباع الخطوات الآتية: -1. قم بعمل مشكلة على جيت هب -2. ناقش هذه المشكلة -3. الحصول على موافقة للتقدم بطلب سحب (PR) -4. غير الشفرة المصدرية -5. قم بطلب سحب -6. ناقش طلب السحب -7. الموافقة على طلبك وضمه +
    +
  1. قم بعمل مشكلة على جيت هب
    2. +
  2. ناقش هذه المشكلة
    3. +
  3. الحصول على موافقة للتقدم بطلب سحب (PR)
    4. +
  4. غير الشفرة المصدرية
    5. +
  5. قم بطلب سحب
    6. +
  6. ناقش طلب السحب
    7. +
  7. الموافقة على طلبك وضمه
    8. +
تصفح هذه[ الصفحة](./contributor_guidelines.md)، حيث سيتم توجهيك خطوة بخطوة لتنفذ الخطوات المذكورة أعلاه، يمكنك أن تستعمل فهرس الصفحة المذكورة لتصل إلى الأجزاء التي تريد مراجعتها أو تذكرها. From f3ac9ef82f189905080ce91ea088a1767d8f0fb6 Mon Sep 17 00:00:00 2001 From: Mostafa Ewis <64862002+MostafaEwis@users.noreply.github.com> Date: Tue, 14 Feb 2023 06:43:41 +0200 Subject: [PATCH 7/8] Final revision and fixes MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit I used some words instead of others to fit the context better like: "العديد" instead of "الكثير" I eliminated the use of unnecessary "مصدر مؤول" which makes the text more comfortable to read. I fixed typos like "شفرة" and "الوقتن" I tried to rephrase some of the text to make it more meaningful I found an Arabic version of the ReactJS docs so I used the terminology they used for the GitHub terms like: pull request and issue, I used the terms "طلب مشكلة" and "طلب سحب" --- contributor_docs/ar/README.md | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/contributor_docs/ar/README.md b/contributor_docs/ar/README.md index d6141abeb2..a6e3e0b643 100644 --- a/contributor_docs/ar/README.md +++ b/contributor_docs/ar/README.md @@ -1,11 +1,11 @@ # 🌸مرحبا 🌺 -شكرا لإهتمامك بالمساهمة في p5.js! مجتمعنا يقدر المساهمات في كل أشكالها ويسعى إلى توسيع معنى كلمة "مساهم" بأقصى شكل ممكن؛ بشكل يتضمن توثيق البرمجيات، التدريس، كتابة الشفرة البرمجية، صناعة الفن، الكتابة، التصميم، النشاطية، التنظيم، نَظْم المحتوى أو أي شيء أخر يمكن أن تتخيله. [صفحة المجتمع خاصتنا](https://p5js.org/community/#contribute) تعطي ملخصا للطرق المختلفة التي يمكن بها أن تشارك وتساهم معنا. +شكرا لإهتمامك بالمساهمة في p5.js! مجتمعنا يقدر المساهمات بكل أشكالها ويسعى إلى توسيع معنى كلمة "مساهم" بأقصى شكل ممكن؛ بشكل يتضمن توثيق البرمجيات، التدريس، كتابة الشيفرة البرمجية، صناعة الفن، الكتابة، التصميم، النشاطية، التنظيم، نَظْم المحتوى أو أي شيء أخر يمكن أن تتخيله. [صفحة المجتمع خاصتنا](https://p5js.org/community/#contribute) تعطي ملخصا للطرق المختلفة التي يمكن بها أن تشارك وتساهم معنا. -هذا المشروع يتبع مواصفات مشروع [all-contributors "كل المساهمين"](https://github.com/kentcdodds/all-contributors). نحن نستعمل البوت @all-contributors كي نضيف المساهمين إلى الملف README.md. يمكنك أن تطلب من البوت @all-contributors أن يضيفك عن طريق كتابة الآتي في تعليق على مشكلة على جيت هب أو طلب سحب PR: +هذا المشروع يتبع المواصفات القياسية لمشروع [all-contributors "كل المساهمين"](https://github.com/kentcdodds/all-contributors). نحن نستعمل البوت @all-contributors كي نضيف المساهمين إلى الملف README.md. يمكنك أن تطلب من البوت @all-contributors إضافتك عن طريق كتابة الآتي في تعليق على طلب مشكلة "issue" على جيت هب "GitHub" أو طلب سحب"pull request" : ``` @all-contributors please add @[اسم المسخدم خاصتك على جيت هب] for [نوع مساهمتك] ``` -يمكنك أن تعرف نوع مساهمتك الشائع من [هنا](https://allcontributors.org/docs/en/emoji-key)، على الرغم من أننا غالبا سنضيفك بشكل تلقائي إلى قائمة المساهمين بعد قبول طلب السحب خاصتك. دليل المساهمين منشور على [موقع](https://p5js.org/contributor-docs/#/) p5.js ومستضاف على[ مستودع "repository" جيت هب](https://github.com/processing/p5.js/tree/main/contributor_docs) الخاص بـ p5.js. +يمكنك معرفة نوع مساهمتك الشائع من [هنا](https://allcontributors.org/docs/en/emoji-key)، على الرغم من أننا غالبا سنضيفك بشكل تلقائي إلى قائمة المساهمين بعد قبول طلب السحب خاصتك. دليل المساهمين منشور على [موقع](https://p5js.org/contributor-docs/#/) p5.js ومُستضاف على[ مستودع "repository" جيت هب](https://github.com/processing/p5.js/tree/main/contributor_docs) الخاص بـ p5.js. # قبل أن تساهم معنا المساهمة في مشروع p5.js يجب أن تكون تجربة خالية من أي ضغط، فنحن نرحب بكل المساهمات بغض النظر عن حجمها، سواء قد قمت بإصلاح خطأ مطبعي بسيط أو أعدت هيكلة الآليات المعقدة لعرض الرسوم ثلاثية الأبعاد، لكن توجد بعض الأشياء التي يجب أن تألفها وتفهمها قبل أن تبدأ في المساهمة. @@ -16,35 +16,35 @@ # ابدأ -الأن أنت مستعد لتبدأ المساهمة في p5.js! هناك العديد من الطرق لتبدأ المساهمة إلى p5.js وأيضا العديد من الأسباب لتساهم معنا. في سياق هذا الدليل، سنقسم المساهمات بشكل عام إلى قسمين: +الآن أنت مستعد لتبدأ المساهمة في p5.js! هناك العديد من الطرق لتبدأ المساهمة إلى p5.js وأيضا العديد من الأسباب لتساهم معنا. في سياق هذا الدليل، سنقسم المساهمات بشكل عام إلى قسمين: على حسب نوع المساهمة التي ستقوم بها إلى p5.js، من فضلك قم بقراءة الجزء المناسب من هذا الدليل. -## [المساهمات إلى الشفرة المصدرية](./contributor_guidelines.md) +## [المساهمات إلى الشيفرة المصدرية](./contributor_guidelines.md) لتقوم بمساهمة مثالية إلى مستودع p5.js أو موقع p5.js، قم بإتباع الخطوات الآتية:
    -
  1. قم بعمل مشكلة على جيت هب
    2. -
  2. ناقش هذه المشكلة
    3. -
  3. الحصول على موافقة للتقدم بطلب سحب (PR)
    4. -
  4. غير الشفرة المصدرية
    5. +
  5. قم بعمل طلب مشكلة على جيت هب
    6. +
  6. ناقش طلب المشكلة
    7. +
  7. الحصول على موافقة للتقدم بطلب سحب
    8. +
  8. غير الشيفرة المصدرية
  9. قم بطلب سحب
  10. ناقش طلب السحب
  11. الموافقة على طلبك وضمه
-تصفح هذه[ الصفحة](./contributor_guidelines.md)، حيث سيتم توجهيك خطوة بخطوة لتنفذ الخطوات المذكورة أعلاه، يمكنك أن تستعمل فهرس الصفحة المذكورة لتصل إلى الأجزاء التي تريد مراجعتها أو تذكرها. +تصفح هذه[ الصفحة](./contributor_guidelines.md)، حيث سيتم توجهيك خطوة بخطوة لتنفذ الخطوات المذكورة أعلاه، يمكنك استعمال فهرس تلك الصفحة لتصل إلى الأجزاء التي تريد مراجعتها أو تذكرها. -معظم الوقت سنسير بحزم على خطة العمل هذه، قد تشعر بأننا نقوم بالكثير من المناورات من أجل ما يبدو مساهمة بسيطة، وبخاصة إذا قد قمت بالمساهمة في مشاريع أخرى. رغم ذلك، فإننا نهدف بالخطوات المذكورة أعلاه بأن نسهل عليك كمساهم أو كمتعهد/مشرف المساهمة بشكل هادف ذو معنى، وفي نفس الوقت نحرص على ألا تضيع وقتك في عمل قد يُرفض لأسباب كثيرة. الخطوات أعلاه تساعد في أن نضمن أن كل اقتراح أو إصلاح قد نوقش بشكل وافٍ قبل البدأ في تنفيذه، مما سيوفر عليك (والمتعهدين والمشرفين) الوقتن، حيث ستقل طلبات السحب التي تتطلب المزيد من التعديلات بعد مراجعتها، أو الإصلاحات المرفوضة من البداية بشكل صريح. +معظم الوقت سنسير بحزم على خطة العمل هذه، قد تشعر بأننا نقوم بالعديد من المناورات من أجل ما يبدو مساهمة بسيطة، وبخاصة إذا قمت بالمساهمة في مشاريع أخرى. رغم ذلك، فإننا نهدف بالخطوات المذكورة أعلاه بأن نسهل عليك كمساهم أو كمتعهد/مشرف المساهمة بشكل هادف ذو معنى، وفي نفس الوقت نحرص على ألا تضيع وقتك في عمل قد يُرفض لأسباب كثيرة. الخطوات أعلاه تساعد في ضمان أن كل اقتراح أو إصلاح قد نوقش بشكل وافٍ قبل البدأ في تنفيذه، مما سيوفر عليك (والمتعهدين والمشرفين) الوقت، حيث ستقل طلبات السحب التي تتطلب المزيد من التعديلات بعد مراجعتها، أو الإصلاحات المرفوضة من البداية بشكل صريح. **نحن نرى المساهمة إلى p5.js كفرصة للتعلم** ولا نقيس النجاح بعدد المساهمات التي تصلنا. لا توجد مهلة تَحدُك حتى تنفذ مساهمتك، لذا خذ وقتك وأعمل بسرعة تناسبك (قد نراسلك إذا غبت لفترة طويلة). يمكنك سؤال المتعهدين أو المشرفين إذا احتجتهم وسوف نبذل قصاري جهدنا حتى نساعدك. -## المساهمات إلى غير الشفرة المصدرية -هناك العديد من الطرق كي تساهم إلى p5.js بعيدا عن الشفرة المصدرية، أكثر حتى من أن نحصيها هنا، بعض الطرق قد تتضمن العمل مع مستودع p5.js (كإضافة الأمثلة، أو كتابة درس للموقع، إلخ). على حسب المساهمة المخطط لها، قد نكون قادرين على مساعدتك بطرق عدة، لذا تواصل معنا عبر أي قناة من قنوات التواصل المتاحة لك (البريد الإلكتروني، وسائل التواصل الإجتماعي، منتدى النقاش، ديسكورد، إلخ). +## المساهمات إلى غير الشيفرة المصدرية +هناك العديد من الطرق كي تساهم إلى p5.js بعيدا عن الشيفرة المصدرية، أكثر حتى من أن نحصيها هنا، بعض الطرق قد تتضمن العمل مع مستودع p5.js (كإضافة الأمثلة، أو كتابة درس للموقع، إلخ). على حسب المساهمة المخطط لها، قد نكون قادرين على مساعدتك بطرق عدة، لذا تواصل معنا عبر أي قناة من قنوات التواصل المتاحة لك (البريد الإلكتروني، وسائل التواصل الإجتماعي، منتدى النقاش، ديسكورد، إلخ). ## [المتعهدين والمشرفين](./steward_guidelines.md) From 0beddcfca0b7323069426f2e1e79c5f94b55ea81 Mon Sep 17 00:00:00 2001 From: Mostafa Ewis <64862002+MostafaEwis@users.noreply.github.com> Date: Mon, 6 Mar 2023 01:08:13 +0200 Subject: [PATCH 8/8] Omitted the gender bias from the language and used gender neutral forms MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - I kept the words which ends with "ضمير الوصل" "ك" and used no vocal characters as it depends on the reader to read it as the gender they think they are. - I kept the "ت" in the the end of verbs as it can be treated as "تاء الفاعل" or "تاء التأنيث" depending on the reader. - I used the "/ات" where I found no other way to omit the use of "جمع المذكر السالم" or no neutral way to mention the words "متعهد", "مساهم ", " مشرف". - The trickiest part was the "صيغة الفعل الأمر" which differs a lot depending on the gender you are calling so I had to omit most of them and used non imperative form which made the meaning differ but didn't really change it, except for line 13 where I found no way to use other forms than the imperative so I used it and added both of the forms for both genders. this overall made the meaning of some text differ but didn't really change it. I think it was better and more neutral to include the whole feminine word for words such as "مساهم" and the form "جمع المذكر السالم" but that was really going to make the text much much longer. --- contributor_docs/ar/README.md | 46 +++++++++++++++++------------------ 1 file changed, 23 insertions(+), 23 deletions(-) diff --git a/contributor_docs/ar/README.md b/contributor_docs/ar/README.md index a6e3e0b643..7379dfd971 100644 --- a/contributor_docs/ar/README.md +++ b/contributor_docs/ar/README.md @@ -1,52 +1,52 @@ # 🌸مرحبا 🌺 -شكرا لإهتمامك بالمساهمة في p5.js! مجتمعنا يقدر المساهمات بكل أشكالها ويسعى إلى توسيع معنى كلمة "مساهم" بأقصى شكل ممكن؛ بشكل يتضمن توثيق البرمجيات، التدريس، كتابة الشيفرة البرمجية، صناعة الفن، الكتابة، التصميم، النشاطية، التنظيم، نَظْم المحتوى أو أي شيء أخر يمكن أن تتخيله. [صفحة المجتمع خاصتنا](https://p5js.org/community/#contribute) تعطي ملخصا للطرق المختلفة التي يمكن بها أن تشارك وتساهم معنا. +شكرا لإهتمامك بالمساهمة في p5.js! مجتمعنا يقدر المساهمات بكل أشكالها ويسعى إلى توسيع معنى كلمة "مساهم/ة" بأقصى شكل ممكن؛ بشكل يتضمن توثيق البرمجيات، التدريس، كتابة الشيفرة البرمجية، صناعة الفن، الكتابة، التصميم، النشاطية، التنظيم، نَظْم المحتوى أو أي شيء أخر يمكن أن تتخيله. [صفحة المجتمع خاصتنا](https://p5js.org/community/#contribute) تعطي ملخصا للطرق المختلفة التي يمكن بها المشاركة والمساهمة معنا. -هذا المشروع يتبع المواصفات القياسية لمشروع [all-contributors "كل المساهمين"](https://github.com/kentcdodds/all-contributors). نحن نستعمل البوت @all-contributors كي نضيف المساهمين إلى الملف README.md. يمكنك أن تطلب من البوت @all-contributors إضافتك عن طريق كتابة الآتي في تعليق على طلب مشكلة "issue" على جيت هب "GitHub" أو طلب سحب"pull request" : +هذا المشروع يتبع المواصفات القياسية لمشروع [all-contributors "كل المساهمين"](https://github.com/kentcdodds/all-contributors). نحن نستعمل البوت @all-contributors كي نضيف المساهمين/ات إلى الملف README.md. يمكنك الطلب من البوت @all-contributors أن يضيفك عن طريق كتابة الآتي في تعليق على طلب مشكلة "issue" على جيت هب "GitHub" أو طلب سحب"pull request" : ``` @all-contributors please add @[اسم المسخدم خاصتك على جيت هب] for [نوع مساهمتك] ``` -يمكنك معرفة نوع مساهمتك الشائع من [هنا](https://allcontributors.org/docs/en/emoji-key)، على الرغم من أننا غالبا سنضيفك بشكل تلقائي إلى قائمة المساهمين بعد قبول طلب السحب خاصتك. دليل المساهمين منشور على [موقع](https://p5js.org/contributor-docs/#/) p5.js ومُستضاف على[ مستودع "repository" جيت هب](https://github.com/processing/p5.js/tree/main/contributor_docs) الخاص بـ p5.js. +يمكنك معرفة نوع مساهمتك المناسب من [هنا](https://allcontributors.org/docs/en/emoji-key)، على الرغم من أننا غالبا سنضيفك بشكل تلقائي إلى قائمة المساهمين بعد قبول طلب السحب خاصتك. دليل المساهمين منشور على [موقع](https://p5js.org/contributor-docs/#/) p5.js ومُستضاف على[ مستودع "repository" جيت هب](https://github.com/processing/p5.js/tree/main/contributor_docs) الخاص بـ p5.js. -# قبل أن تساهم معنا -المساهمة في مشروع p5.js يجب أن تكون تجربة خالية من أي ضغط، فنحن نرحب بكل المساهمات بغض النظر عن حجمها، سواء قد قمت بإصلاح خطأ مطبعي بسيط أو أعدت هيكلة الآليات المعقدة لعرض الرسوم ثلاثية الأبعاد، لكن توجد بعض الأشياء التي يجب أن تألفها وتفهمها قبل أن تبدأ في المساهمة. +# قبل المساهمة معنا +المساهمة في مشروع p5.js يجب أن تكون تجربة خالية من أي ضغط، فنحن نرحب بكل المساهمات بغض النظر عن حجمها، سواء كانت إصلاح خطأ مطبعي بسيط أو إعادة هيكلة الآليات المعقدة لعرض الرسوم ثلاثية الأبعاد، لكن توجد بعض الأشياء التي يجب معرفتها وفهمها قبل البدء في المساهمة. -بدايةً: من فضلك قم بقراءة [بيان مجتمعنا](https://p5js.org/community/) +بدايةً: من فضلك قم/قومي بقراءة [بيان مجتمعنا](https://p5js.org/community/) -أما بعد: نحن حاليا نعطي الأولوية للأعمال التي تُزيد الوصول (إمكانية الوصول والإتاحة وحقوق المعاقين) لـ p5.js! للمزيد من التفاصيل، فلتلق نظرة على [بيان الإتاحة خاصتنا](./access.md) +أما بعد: نحن حاليا نعطي الأولوية للأعمال التي تُزيد الوصول (إمكانية الوصول والإتاحة وحقوق المعاقين/ات) لـ p5.js! للمزيد من التفاصيل، يمكنك إلقاء نظرة على [بيان الإتاحة خاصتنا](./access.md) -# ابدأ +# البدء -الآن أنت مستعد لتبدأ المساهمة في p5.js! هناك العديد من الطرق لتبدأ المساهمة إلى p5.js وأيضا العديد من الأسباب لتساهم معنا. في سياق هذا الدليل، سنقسم المساهمات بشكل عام إلى قسمين: +الآن أنت على استعداد لبدء المساهمة في p5.js! هناك العديد من الطرق لبدء المساهمة إلى p5.js وأيضا العديد من الأسباب للمساهمة معنا. في سياق هذا الدليل، سنقسم المساهمات بشكل عام إلى قسمين: -على حسب نوع المساهمة التي ستقوم بها إلى p5.js، من فضلك قم بقراءة الجزء المناسب من هذا الدليل. +على حسب نوع المساهمة المراد القيام بها إلى p5.js، يمكنك قراءة الجزء المناسب من هذا الدليل. ## [المساهمات إلى الشيفرة المصدرية](./contributor_guidelines.md) -لتقوم بمساهمة مثالية إلى مستودع p5.js أو موقع p5.js، قم بإتباع الخطوات الآتية: +للقيام بمساهمة مثالية إلى مستودع p5.js أو موقع p5.js، يجب إتباع الخطوات الآتية:
    -
  1. قم بعمل طلب مشكلة على جيت هب
    2. -
  2. ناقش طلب المشكلة
    3. -
  3. الحصول على موافقة للتقدم بطلب سحب
    4. -
  4. غير الشيفرة المصدرية
    5. -
  5. قم بطلب سحب
    6. -
  6. ناقش طلب السحب
    7. +
  7. عمل طلب مشكلة على جيت هب
    8. +
  8. مناقشة طلب المشكلة
    9. +
  9. الحصول على موافقة لعمل بطلب سحب
    10. +
  10. تغيير الشيفرة المصدرية
    11. +
  11. عمل طلب سحب
    12. +
  12. مناقشة طلب السحب
  13. الموافقة على طلبك وضمه
-تصفح هذه[ الصفحة](./contributor_guidelines.md)، حيث سيتم توجهيك خطوة بخطوة لتنفذ الخطوات المذكورة أعلاه، يمكنك استعمال فهرس تلك الصفحة لتصل إلى الأجزاء التي تريد مراجعتها أو تذكرها. +في هذه[ الصفحة](./contributor_guidelines.md)، سيتم توجهيك خطوة بخطوة لتنفيذ الخطوات المذكورة أعلاه، يمكنك استعمال فهرس تلك الصفحة للوصول إلى الأجزاء المراد مراجعتها أو تذكرها. -معظم الوقت سنسير بحزم على خطة العمل هذه، قد تشعر بأننا نقوم بالعديد من المناورات من أجل ما يبدو مساهمة بسيطة، وبخاصة إذا قمت بالمساهمة في مشاريع أخرى. رغم ذلك، فإننا نهدف بالخطوات المذكورة أعلاه بأن نسهل عليك كمساهم أو كمتعهد/مشرف المساهمة بشكل هادف ذو معنى، وفي نفس الوقت نحرص على ألا تضيع وقتك في عمل قد يُرفض لأسباب كثيرة. الخطوات أعلاه تساعد في ضمان أن كل اقتراح أو إصلاح قد نوقش بشكل وافٍ قبل البدأ في تنفيذه، مما سيوفر عليك (والمتعهدين والمشرفين) الوقت، حيث ستقل طلبات السحب التي تتطلب المزيد من التعديلات بعد مراجعتها، أو الإصلاحات المرفوضة من البداية بشكل صريح. +معظم الوقت سنسير بحزم على خطة العمل هذه، قد يصلك شعور بأننا نقوم بالعديد من المناورات من أجل ما يبدو مساهمة بسيطة، وبخاصة إذا قمت بالمساهمة في مشاريع أخرى. رغم ذلك، فإننا نهدف بالخطوات المذكورة أعلاه بأن نسهل عليك كمساهم/ة أو كمتعهد/ة أوكمشرف/ة المساهمة بشكل هادف ذو معنى، وفي نفس الوقت نحرص على ألا يضيع وقتك في عمل قد يُرفض لأسباب كثيرة. الخطوات أعلاه تساعد في ضمان أن كل اقتراح أو إصلاح قد نوقش بشكل وافٍ قبل البدء في تنفيذه، مما سيوفر عليك (والمتعهدين/ات والمشرفين/ات) الوقت، حيث ستقل طلبات السحب التي تتطلب المزيد من التعديلات بعد مراجعتها، أو الإصلاحات المرفوضة من البداية بشكل صريح. -**نحن نرى المساهمة إلى p5.js كفرصة للتعلم** ولا نقيس النجاح بعدد المساهمات التي تصلنا. لا توجد مهلة تَحدُك حتى تنفذ مساهمتك، لذا خذ وقتك وأعمل بسرعة تناسبك (قد نراسلك إذا غبت لفترة طويلة). يمكنك سؤال المتعهدين أو المشرفين إذا احتجتهم وسوف نبذل قصاري جهدنا حتى نساعدك. +**نحن نرى المساهمة إلى p5.js كفرصة للتعلم** ولا نقيس النجاح بعدد المساهمات التي تصلنا. لا توجد مهلة تَحدُك لتنفيذ مساهمتك، لذا يمكنك اتخاذ الوقت والسرعة المناسبة لك (قد نراسلك إذا غبت لفترة طويلة). يمكنك سؤال المتعهدين/ات أو المشرفين/ات إذا احتجتهم وسوف نبذل قصارى جهدنا حتى نساعدك. ## المساهمات إلى غير الشيفرة المصدرية -هناك العديد من الطرق كي تساهم إلى p5.js بعيدا عن الشيفرة المصدرية، أكثر حتى من أن نحصيها هنا، بعض الطرق قد تتضمن العمل مع مستودع p5.js (كإضافة الأمثلة، أو كتابة درس للموقع، إلخ). على حسب المساهمة المخطط لها، قد نكون قادرين على مساعدتك بطرق عدة، لذا تواصل معنا عبر أي قناة من قنوات التواصل المتاحة لك (البريد الإلكتروني، وسائل التواصل الإجتماعي، منتدى النقاش، ديسكورد، إلخ). +هناك العديد من الطرق للمساهمة إلى p5.js بعيدا عن الشيفرة المصدرية، أكثر حتى من أن نحصيها هنا، بعض الطرق قد تتضمن العمل مع مستودع p5.js (كإضافة الأمثلة، أو كتابة درس للموقع، إلخ). على حسب المساهمة المخطط لها، قد تكون لدينا القدرة على مساعدتك بطرق عدة، لذا يمكنك التواصل معنا عبر أي قناة من قنوات التواصل المتاحة لك (البريد الإلكتروني، وسائل التواصل الإجتماعي، منتدى النقاش، ديسكورد، إلخ). -## [المتعهدين والمشرفين](./steward_guidelines.md) +## [المتعهدين/ات والمشرفين/ات](./steward_guidelines.md) -للدليل الخاص بالمتعهدين أو الصيانة العامة لمستودع p5.js على جيت هب، من فضلك ألق نظرة على [دليل المتعهدين](./steward_guidelines.md) +للدليل الخاص بالمتعهدين/ات أو الصيانة العامة لمستودع p5.js على جيت هب، يمكنك إلقاء نظرة على [دليل المتعهدين](./steward_guidelines.md)