Merge branch 'main' into firstBranch

Author: Roshanjossey

.github/CONTRIBUTING.md

@@ -2,6 +2,6 @@
 
 ## Reporting a Vulnerability
 
-In order for the vulnerability reports to reach maintainers as soon as possible, the preferred way is to use the "Report a vulnerability" button under the "Security" tab of the associated GitHub project. This creates a private communication channel between the reporter and the maintainers.
+In order for vulnerability reports to reach maintainers as soon as possible, the preferred method is to use the "Report a vulnerability" button under the "Security" tab of the associated GitHub project. This creates a private communication channel between the reporter and the maintainers.
 
-If you are absolutely unable to or have strong reasons not to use GitHub's vulnerability reporting workflow, please reach out to the the team by mailing to [email protected]
+If you cannot or prefer not to use GitHub's vulnerability reporting workflow, please reach out to the team by emailing [email protected].

.github/SECURITY.md

@@ -26,9 +26,9 @@
 <kbd>[<img title="Magyar" alt="Magyar" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/hu.svg" width="22">](docs/translations/README.hu.md)</kbd>
 <kbd>[<img title="Bahasa Indonesia" alt="Bahasa Indonesia" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/id.svg" width="22">](docs/translations/README.id.md)</kbd>
 <kbd>[<img title="עִברִית" alt="עִברִית" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/il.svg" width="22">](docs/translations/README.hb.md)</kbd>
-<kbd>[<img title="हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்" alt="हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/in.svg" width="22">](docs/translations/Translations.md)</kbd>
+<kbd>[<img title="ગુજરાતી / हिन्दी / मराठी / മലയാളം / ಕನ್ನಡ / తెలుగు / ଓଡିଆ / छत्तीसगढ़ी / ਪੰਜਾਬੀ" alt="ગુજરાતી / हिन्दी / मराठी / മലയാളം / ಕನ್ನಡ / తెలుగు / ଓଡିଆ / छत्तीसगढ़ी / ਪੰਜਾਬੀ" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/in.svg" width="22">](docs/translations/Translations.md)</kbd>
 <kbd>[<img title="தமிழ்" alt="தமிழ்" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lk.svg" width="22">](docs/translations/README.ta.md)</kbd>
-<kbd>[<img title="فارسی" alt="فارسی" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ir.svg" width="22">](docs/translations/README.fa.md)</kbd>
+<kbd>[<img title="فارسی" alt="فارسی" src="https://upload.wikimedia.org/wikipedia/commons/b/ba/Flag_of_Iran_before_1979_Revolution.svg" width="22">](docs/translations/README.fa.md)</kbd>
 <kbd>[<img title="Italiano" alt="Italiano" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/it.svg" width="22">](docs/translations/README.it.md)</kbd>
 <kbd>[<img title="日本語" alt="日本語" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/jp.svg" width="22">](docs/translations/README.ja.md)</kbd>
 <kbd>[<img title="සිංහල" alt="සිංහල" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lk.svg" width="22">](docs/translations/README.si.md)</kbd>
@@ -69,22 +69,24 @@
 <kbd>[<img title="Latvia" alt="Latvia" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/lv.svg" width="22">](docs/translations/README.lv.md)</kbd>
 <kbd>[<img title="Suomeksi" alt="Suomeksi" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/fi.svg" width="22">](docs/translations/README.fi.md)</kbd>
 <kbd>[<img title="Беларуская мова" alt="Беларуская мова" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/by.svg" width="22">](docs/translations/README.by.md)</kbd>
-<kbd>[<img title="Српски" alt="Српски" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/rs.svg" width="22">](docs/translations/README.sr.md)</kbd>
+<kbd>[<img title="Српски" alt="Српски" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/rs.svg" width="22">](docs/translations/README.sr-Cyrl.md)</kbd>
+<kbd>[<img title="Srpski" alt="Srpski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/rs.svg" width="22">](docs/translations/README.sr-Latn.md)</kbd>
 <kbd>[<img title="Қазақша" alt="Қазақша" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/kz.svg" width="22">](docs/translations/README.kz.md)</kbd>
 <kbd>[<img title="Bosanski" alt="Bosanski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ba.svg" width="22">](docs/translations/README.bih.md)</kbd>
-<kbd>[<img title="Bosanski" alt="Bosanski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/et.svg" width="22">](docs/translations/README.bih.md)</kbd>
 <kbd>[<img title="Hrvatski" alt="Hrvatski" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/hr.svg" width="22">](docs/translations/README.hr.md)</kbd>
 <kbd>[<img title="پښتو" alt="پښتو" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/af.svg" width="22">](docs/translations/README.ps.md)</kbd>
 <kbd>[<img title="Af-soomaali" alt="Somalia" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/so.svg" width="22">](docs/translations/README.so.md)</kbd>
 <kbd>[<img title="Español de Ecuador" alt="Ecuador" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ec.svg" width="22">](docs/translations/README.ec.md)</kbd>
 <kbd>[<img title="Luganda (Uganda)" alt="Luganda (Uganda)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ug.svg" width="22">](docs/translations/README.lug.md)</kbd>
 <kbd>[<img title="Turkmen" alt="Turkmen language" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tm.svg" width="22">](docs/translations/README.tm.md)</kbd>
 <kbd>[<img title="Ewe (TOGO)" alt="Ewe (TOGO)" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tg.svg" width="22">](docs/translations/README.ewe.md)</kbd>
-<kbd>[<img title="አማርኛ" alt="አማርኛ" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/et.svg" width="22">](docs/translations/README.et.md)</kbd>
+<kbd>[<img title="አማርኛ" alt="አማርኛ" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/et.svg" width="22">](docs/translations/README.am.md)</kbd>
 <kbd>[<img title="Kurdî" alt="Kurdî" src="https://upload.wikimedia.org/wikipedia/commons/3/35/Flag_of_Kurdistan.svg" width="22">](docs/translations/README.kr.md)</kbd>
 <kbd>[<img title="Malagasy" alt="Malagasy" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mg.svg" width="22">](docs/translations/README.mg.md)</kbd>
 <kbd>[<img title="ភាសាខ្មែរ" alt="ភាសាខ្មែរ" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/kh.svg" width="22">](docs/translations/README.kh.md)</kbd>
 <kbd>[<img title="Morocco" alt="Moroccan Darija" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ma.svg" width="22">](docs/translations/README.ma.md)</kbd>
+<kbd>[<img title="Mongolian" alt="Mongolian" src="https://cdn.statically.io/flags/mn.svg" width="22">](docs/translations/README.mn.md)</kbd>
+<kbd>[<img title="Tounsi" alt="Tounsi" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tn.svg" width="22">](docs/translations/README.tn.md)</kbd>
 
 # First Contributions
 
@@ -196,7 +198,7 @@ replacing `your-branch-name` with the name of the branch you created earlier.
 - ### Authentication Error
      <pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
   remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
-  fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
+  fatal: Authentication failed for 'https://github.com/&lt;your-username&gt;/first-contributions.git/'</pre>
   Go to [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) on generating and configuring an SSH key to your account.
 
   Also, you might want to run 'git remote -v' to check your remote address.
@@ -220,7 +222,7 @@ If you go to your repository on GitHub, you'll see a `Compare & pull request` bu
 
 Now submit the pull request.
 
-<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
+<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit the pull request" />
 
 Soon I'll be merging all your changes into the main branch of this project. You will get a notification email once the changes have been merged.
 
@@ -241,10 +243,3 @@ Now let's get you started with contributing to other projects. We've compiled a
 | <a href="docs/gui-tool-tutorials/github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="100"></a> | <a href="docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md"><img alt="Visual Studio 2017" src="https://upload.wikimedia.org/wikipedia/commons/c/cd/Visual_Studio_2017_Logo.svg" width="100"></a> | <a href="docs/gui-tool-tutorials/gitkraken-tutorial.md"><img alt="GitKraken" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-icon.png" width="100"></a> | <a href="docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md"><img alt="VS Code" src="https://upload.wikimedia.org/wikipedia/commons/1/1c/Visual_Studio_Code_1.35_icon.png" width=100></a> | <a href="docs/gui-tool-tutorials/sourcetree-macos-tutorial.md"><img alt="Sourcetree App" src="https://wac-cdn.atlassian.com/dam/jcr:81b15cde-be2e-4f4a-8af7-9436f4a1b431/Sourcetree-icon-blue.svg" width=100></a> | <a href="docs/gui-tool-tutorials/github-windows-intellij-tutorial.md"><img alt="IntelliJ IDEA" src="https://upload.wikimedia.org/wikipedia/commons/thumb/9/9c/IntelliJ_IDEA_Icon.svg/512px-IntelliJ_IDEA_Icon.svg.png" width=100></a> |
 | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | [GitHub Desktop](docs/gui-tool-tutorials/github-desktop-tutorial.md)                                                                                             | [Visual Studio 2017](docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md)                                                                                                                          | [GitKraken](docs/gui-tool-tutorials/gitkraken-tutorial.md)                                                                                                                                        | [Visual Studio Code](docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md)                                                                                                                  | [Atlassian Sourcetree](docs/gui-tool-tutorials/sourcetree-macos-tutorial.md)                                                                                                                                      | [IntelliJ IDEA](docs/gui-tool-tutorials/github-windows-intellij-tutorial.md)                                                                                                                                                          |
-
-<p>This project is supported by:</p>
-<p>
-  <a href="https://www.digitalocean.com/">
-    <img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
-  </a>
-</p>

Contributors.md

@@ -0,0 +1,27 @@
+# ما يمكن لغير المبرمج القيام به
+
+## كن متأنيًا
+
+في مجال البرمجيات مفتوحة المصدر، كل خطوة، سواء كانت برمجة أو جوانب أخرى، تتطلب مساهمة وتفاعل من الآخرين.  
+الانضمام إلى فريق مفتوح المصدر يعني فهم ديناميكيات المجتمع وطريقة عمله. بدلاً من الوصول إلى مشروع والقول فورًا "هذا ما أعتقد أن المشروع يجب أن يفعله"، من الأفضل غالبًا اتباع نهج أكثر انتباهًا.
+
+بعض المشاريع قد ترحب بهذا النهج، لكن إذا كان المشروع قائمًا منذ فترة، فإن احتمالية قبول هذا السلوك تكون منخفضة. الاستماع هو أفضل طريقة لمعرفة ما يحتاجه المشروع.
+
+1. **الاشتراك في قائمة بريدية**: بالنسبة للعديد من المشاريع، تكون القائمة البريدية هي الوسيلة الرئيسية للتواصل حول تطوير المشروع. في المشاريع الكبيرة، توجد قوائم بريدية متعددة. على سبيل المثال، يحتوي مشروع PostgreSQL على 12 قائمة موجهة للمستخدمين و6 قوائم للمطورين. يُنصح بالبدء بالاشتراك في القائمة الرئيسية للمستخدمين والقائمة الرئيسية للمطورين للاستماع أولًا.
+2. **متابعة مدونة**: المدونات التي يديرها المطورون الرئيسيون غالبًا ما توفر معلومات عن الإصدارات القادمة والخطوات اللازمة. مواقع مثل "planet" تجمع أخبارًا ومقالات من مصادر متعددة متعلقة بالمشروع، مثل planet.gnome.org أو planet.mysql.com.
+3. **الانضمام إلى قناة IRC**: العديد من المشاريع لديها قنوات IRC (الدردشة عبر الإنترنت) حيث يجتمع المطورون والمستخدمون لمناقشة المشاكل والتطوير. تحقق من موقع المشروع لمعرفة اسم القناة والشبكة.
+4. **العمل مع التذاكر (tickets)**: البرمجة ليست الطريقة الوحيدة للمساهمة. صيانة الشيفرة والأنظمة المحيطة بها غالبًا ما تكون مهملة، وهذه فرصة سهلة للمشاركة. معظم المشاريع لديها نظام تذاكر يمكن الوصول إليه من الجميع. الحفاظ على تحديث التذاكر طريقة ممتازة للمساعدة.
+5. **تشخيص الأخطاء**: في كثير من الأحيان يتم الإبلاغ عن الأخطاء بشكل غير واضح. تشخيص الأخطاء ومراجعتها يساعد المطورين على فهم المشكلة بسرعة. حتى لو لم تعرف سبب المشكلة، فإن جهودك لتقليل الظروف تساعد الآخرين على حلها بسهولة.
+6. **إغلاق الأخطاء المصححة**: أحيانًا يتم تصحيح الأخطاء في الشيفرة لكن التذاكر المتعلقة بها لا تُغلق. مراجعة هذه التذاكر مهمة جدًا. ابدأ بالتأكد من التذاكر القديمة وقم بإغلاق ما تم حله.
+7. **اختبار إصدار تجريبي أو مرشح للإصدار**: يمكن أن تواجه المشاريع مشاكل توافق على منصات مختلفة. اختبار الإصدارات التجريبية يساعد المشروع على التأكد من جودة الإصدار النهائي.
+8. **تصحيح خطأ**: عادة ما يبدأ المساهمون بحل الأخطاء. حدد خطأً وحاول تصحيحه، وأضف اختبارات إذا لزم الأمر.
+9. **كتابة اختبار (Test)**: معظم المشاريع لديها اختبارات، لكن هناك دائمًا مجال لإضافة اختبارات جديدة لتغطية أجزاء لم تُختبر بعد.
+10. **إخفاء تحذيرات المترجم (compiler warnings)**: في المشاريع بلغة C أو غيرها، قد تظهر تحذيرات لا تشير إلى خطأ حقيقي. إزالة هذه التحذيرات يحسن وضوح عملية البناء.
+11. **إضافة تعليق (Comment)**: عند قراءة الشيفرة، إذا وجدت جزءًا مربكًا، أضف تعليقًا لتوضيحه للآخرين.
+12. **إنشاء مثال**: لا يوجد مشروع يمكن أن يحتوي على أمثلة كثيرة جدًا. إنشاء مثال عملي يوضح طريقة استخدام البرنامج يساعد المستخدمين الجدد.
+13. **التفاعل مع المجتمع**: الرد على أسئلة الآخرين، خاصة المبتدئين، يساعد المشروع على النمو ويجعل المجتمع نشطًا.
+14. **كتابة تدوينة (Blog Post)**: مشاركة تجاربك مع المشروع تساعد الآخرين وتوثق خبرتك.
+15. **تحسين موقع الويب**: إذا كانت لديك مهارات تصميم، يمكنك تحسين موقع المشروع أو الشعارات، مما يعزز صورة المشروع.
+16. **كتابة وثائق تقنية**: كتابة توثيق عن المشروع مفيد، حتى لو لم تكن مبرمجًا، لتسهيل استخدام المشروع على الآخرين.
+17. **التعليم ومساعدة الآخرين**: أفضل طريقة لتعلم شيء جديد هي محاولة تعليمه للآخرين، فالتدريس يعزز فهمك ومهاراتك.
+