Merge branch 'main' into adarsh

2025-12-20 13:44:05 +01:00 · 2023-05-16 01:21:09 +02:00 · 2023-05-16 01:21:09 +02:00 · f10d7a2662
commit f10d7a2662
parent 7894008baa 7f1cea1708
4 changed files with 230 additions and 5 deletions
--- a/Contributors.md
+++ b/Contributors.md
@ -1,39 +1,50 @@
 # Contributors
-
+[Shantanu Nautiyal](https://github.com/shantanunautiyal)
 <!-- prettier-ignore-start -->
 - [Adarsh Yadav](https://github.com/codebreaker0001)
+- [Milan Lakhani](https://github.com/milan-lakhani)
 - [Aditya patil](https://github.com/AdityaPatil111)
+- [Andre Chua](https://github.com/andrechuakj)
 - [Hastimal Shah](https://github.com/hasti)
+- [Zvirid Andrei](https://github.com/zviridandrei)
 - [Zach Boquet](https://github.com/Kurokio)
 - [Akhil](https://github.com/Akhil-77)
 - Md Raquib 🔥🔥 (https://github.com/RaquibDox)
+- IamMahfooz
 - [Noriomusha](https://github.com/Noriomusha)
 -Utkarsh Shukla(https://github.com/utkrsh-shukla)
 - [Sarthak](https://github.com/sarthak2131)
 - [Fred Gerner](https://github.com/fgerner)
+- [Lukasz Gzella](https://github.com/lukasgzella)
 - [Lucas Moyano](https://github.com/LucasEPK)
+- [Anand Raj](https://github.com/anand346)
 - [Shruti Singh](https://github.com/shruti8302)
 - [Prabal Sharma](https://github.com/prabalsh19)
 - [JT Fox](https://github.com/jtfox142)
 - [Yuvraj Katkar](https://github.com/YuvrajKatkar)
+- [Meghanath Reddy](https://github.com/meghanath852)
 - [Malki Malov](https://github.com/MalkiMalov)
 - [Gunjan Mishra](https://github.com/GunjanKMishra)
 - [Meenakshi Sivakumar](https://github.com/Meenakshi-Sivakumar)
 - [Swastik Bansal](https://github.com/swastikbansal)
+- [Krutartha Nagesh] (https://github.com/krutartha)
 - [Vance Sama](https://github.com/VansRouges)
 - [Mushfiqur Rahman](https://github.com/mushfiq13)
+- [birendra07] (https://github.com/birendra07)
 - [Thamer](https://github.com/ThamerMalki)
 - [Saukar Manjunath](https://github.com/ManjunathSaukar)
 - [Kamal Koranga](https://github.com/Kamalkoranga)
 - [Gonzalo Berhouet](https://github.com/gonzalober)
 - [Michael McKnight](https://github.com/MichaelMcKnight)
 - [Letizia DI MAIO] (https://github.com/leta91)
+- [Olaoye Muhammad-Nabeel] (https://github.com/Developer-in-Tech)
 - [Nina Dijkstra](https://github.com/N-Dijkstra)
 - [Sakshi Raut](https://github.com/SakshiRaut674)
 - [Saurabh Farkade] (https://github.com/saurabh0413)
 - [Jackeastern](https://github.com/Jackeastern)
 - [Chris Pan](https://github.com/szupzj18)
 - [Aery Zhao](https://github.com/aeryzhao)
+- [Pirajesh M R] (https://github.com/verz0)
 - [Allan Robert Tan](https://github.com/eillanrt)
 - [nionyn](https://github.com/nionyn)
 - [exepag](https://github.com/exequielpagliari)
@ -67,10 +78,12 @@
 - [Chana Ilani](https://github.com/chanafriedman)
 - [Gamapg](https://github.com/gamapg)
 - Balaji Sadanala
- [Anastasiia Koba](https://github.com/anastasiia-koba) -[Rivki Zohar] (https://github.com/Rivki7)
+- [Anastasiia Koba](https://github.com/anastasiia-koba) 
+[Rivki Zohar](https://github.com/Rivki7)
 - [anchit jain](https://github.com/anchit85426)
 - [RaeEE454](https://github.com/RaeEE454)
 - [Manav Tore](https://github.com/manavtore)
+- [Shantanu Nautiyal](https://github.com/shantanunautiyal)
 - [Leandro Robert](https://github.com/leanrobert)
 - [Adnan Mostafa](https://github.com/AdnanMostafa)
 - Jagdish Kancharapu
@ -94,6 +107,7 @@
 - [Riya Patidar](https://github.com/riyapatidar1507)
 - [Nitin Chaudhary](https://github.com/AnCyNitinChaudhary)
 - [Rutvikjoshi63](https://github.com/rutvikjoshi63)
+- [Rohit Sarkar](https://github.com/rohit250799)
 - [Amirkhan](https://github.com/torexanovich)
 - Shilat Ben David
 - [Noobility](https://github.com/Noobility)
@ -203,6 +217,7 @@
 - [John Clapper](https://github.com/britzky)
 - [Maria Aurellia](https://github.com/mariaadannies)
 - [Sahood cv](https://github.com/sahoodcode)
+- [It's Meghanath again](https://github.com/meghanath852)
 - [Harish Rane](https://github.com/AzadRane)
 - [Glen Wojnar](https://github.com/glwo)
 - [Abhinav Thapa](https://github.com/abhinavthapa1998)
@ -352,6 +367,7 @@ chani-israel
 - [Musa Blackfrost](https://github.com/musagenius345)
 - [💻 Aline Bevilacqua ✨](https://github.com/Aliine98)
 - [Satyam singh](https://github.com/jirayanaruto)
+- [Gabor Toth](https://github.com/tgmaster80)
 - [Lior Haim](https://github.com/LiorHaimGit)
 - [Jacob Albert](https://github.com/jalbert90)
 - [Ruth Ikegah](https://github.com/Ruth-ikegah)
@ -493,6 +509,7 @@ chani-israel
 - [Miguel Auccahuasi](https://github.com/sakugemiaru)
 - [Priyanshu Gourav Sarangi](https://github.com/pgs17)
 - [kosen13](https://github.com/kosen13)
+- [K-Huynh](https://github.com/CheckeredCookie)
 - [DOngre Jaipal](https://github.com/Wolfjai513)
 - [Suman Parui](https://github.com/suman897)
 - [Noa Jakob](https://github.com/TrinityOfNJK)
@ -612,6 +629,7 @@ chani-israel
 - [Tanmay Pradhan](https://github.com/tanmaypradhan4112)
 - [Chirag Goyal](https://github.com/ChiragGoyal98)
 - [Animesh Singh](https://github.com/Animesh0764)
+- [Meghanath Reddy](https://github.com/meghanath852)
 - [Jeet Oza](https://github.com/Oza-Jeetkumar-Vishnubhai)
 - [Ayush Dodiya](https://github.com/AHD153)
 - [KDE030617](https://github.com/KDE030617)
@ -716,6 +734,7 @@ chani-israel
 - [White Hat Gamer](https://GitHub.com/WhiteHatGamer)
 - [iParadocx](https://github.com/iParadocx)
 - [Aditya Pudaruth](https://github.com/Aditya-Pudaruth)
+- [Meghanath](https://github.com/meghanath852)
 - [Aman Choudhary](https://github.com/aman-choudhary1)
 - [Dmitrii Sidenko](https://github.com/DmSide)
 - [Heloise Ouvry](https://github.com/heloiseouvry)
@ -751,6 +770,7 @@ chani-israel
 - [Daniel Choike](https://github.com/danielchoike2)
 - [vanagas11](https://github.com/vanagas11)
 - [David K.](https://github.com/David-Killian)
+- [John Nam](https://github.com/johnnam1121)
 - [Chris D](https://github.com/nesdev85)
 - [Hippolyte Thomas](https://github.com/hippothomas)
 - [Alexis Gonzalez](https://github.com/Alex-is-Gonzalez)
@ -886,6 +906,7 @@ chani-israel
 - [Nick](https://github.com/comfythread)
 - [Srivathsan V](https://github.com/Srivathsan-V)
 - [Ivan Delgado](https://github.com/vndlgd)
+- [Janik B](https://github.com/zbakin)
 - [TJ Albertson](https://github.com/TJ-Albertson)
 - [Ruthik Jadhav](https://github.com/Ruthik130201)
 - [Don](https://github.com/Donlebon)
@ -999,6 +1020,7 @@ chani-israel
 - [Adam Anderson](https://github.com/Adam-E-Anderson)
 - [Mayank Agrawal](https://github.com/Mayank30-creator)
 - [Emon](https://github.com/smremon)
+- [Levik k](https://github.com/Levik931)
 - [Sham Vijay](https://github.com/iamvbenz49)
 - [Sunday Jimoh](https://github.com/sunday4me)
 - [Stiliyan Stoyanov](https://github.com/StiliyanStoyanov)
@ -1665,6 +1687,7 @@ chani-israel
 - [Orion Wesson] (https://github.com/EnterOrion)
 - [San-ctuary](https://github.com/San-ctuary)
 - [Thiago Fukuyama Marcilli](https://github.com/ThiagoFukuyama)
+-[Ayush Tibrewal](https://github.com/chromo4)
 - [Rayner Susanto](https://github.com/raynersusanto0)
 - [Ahmed ElSaeed](https://github.com/asmpro7)
 - [Krishnaraja Sagar](https://krishnarajasagar.github.io)
@ -1693,4 +1716,6 @@ chani-israel
 - [Lennart Pries](https://github.com/lennart02)
 - Aviya Atias
 - [Carlos Sais](https://github.com/csais3)
+- [Sameer Kumar singh](https://github.com/xvisierra)
 - <!-- prettier-ignore-end -->
+- [Jimmy Batuhan](https://github.com/jimmybatuhan)
--- a/additional-material/translations/amending-a-commit.fa.md
+++ b/additional-material/translations/amending-a-commit.fa.md
@ -0,0 +1,85 @@
+# اصلاح یک کامیت
+
+چه کار باید بکنی اگر یک تغییر را به مخزن کامیت کردی ولی بعدا متوجه شدی که پیام کامیت مشکل داشته و یا فراموش کردی یک خط به آخرین کامیتت اضافه کنی.
+چجوری میشود این را اصلاح کرد؟
+این موضوعی است که در این آموزش به آن پرداخته میشود.
+
+## تغییر دادن پیام یک کامیت که اخیرا به گیت هاب ارسال کردی
+برای این کار بدون باز کردن  فایلی:
+
+1.تایپ کنید:
+
+```
+git commit --amend -m "پیام جدید برای این کامیت"
+```
+
+2.دستور
+  
+```
+git push origin <نام-شاخه>
+```
+
+را اجرا کنید تا تغییرات در مخزن ثبت شوند
+
+<br/>
+
+نکته: اگر فقط تایپ کنی
+```git commit --amend```، ویرایشگر متنت باز خواهد شد و درخواست تغییر پیام کامیت را خواهد داشت.
+اضافه کردن ```m-``` از این پیشگیری می کند.
+
+## اصلاح کردن یک کامیت
+
+حالا اگر فراموش کرده باشی که یک تغییر کوچک مثل اضافه کردن یک کلمه به یک فایل را انجام بدی، و قبلا تغییرات را ثبت و به مخزن ارسال کرده باشی، چیکار باید انجام بدی؟
+
+مثلا این لاگ (log) کامیت هاست:
+```
+g56123f create botfile 
+a2235d updated contributor.md
+a5da0d modified  botfile
+```
+
+برای مثال فراموش کردی که یک کلمه به (botfile) اضافه کنی.
+
+از دو روش  میشود این کار را انجام داد.
+
+راه اول این است که یک کامیت جدید ایجاد کرد که شامل این تغییرات هست:
+```
+g56123f create botfile 
+a2235d updated contributor.md
+a5da0d modified  botfile
+b0ca8f added single word to botfile
+```
+
+ راه دوم این است که کامیت (a5da0d) را اصلاح کنی، کلمه جدید را اضافه کنی و به عنوان "یک" کامیت به مخزن ارسال کنی.
+این راه به نسبت بهتر است برای اینکه فقط یک تغییر کوچک است.
+
+برای این کار به ترتیب:
+
+1.فایل را اصلاح کن. در این مثال فایل (botfile) را اصلاح میکنیم تا کلمه جدید  را اضافه کنیم.
+
+2.فایل را به تغییرات اضافه کنید:
+
+```
+git add <اسم-فایل>
+```
+
+معمولا بعد از اضافه کردن تغییرات، با دستور 
+
+```
+git commit -m "our commit message"
+```
+
+تغییرات را ثبت میکنیم، ولی به خاطر اینکه می خواهیم کامیت قبلی را اصلاح کنیم، این دستور را اجرا کنیم:
+
+```
+git commit --amend
+```
+با اجرای این دستور ویرایشگر متن باز خواهد شد و تا پیام کامیت را تغییر بدی
+
+ویرایشگر متن را ببند
+تغییرات رو به مخزن ارسال کن..
+```
+git push origin <اسم-شاخه>
+```
+
+تمام شد. الان هر دو تغییر در یک کامیت ثبت شده اند.
--- a/gui-tool-tutorials/translations/gitkraken-tutorial-es.md
+++ b/gui-tool-tutorials/translations/gitkraken-tutorial-es.md
@ -0,0 +1,116 @@
+[![Amor por el Código Abierto](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)
+[<img align="right" width="150" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
+[![Licencia: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Ayudantes de Código Abierto](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions)
+
+
+# Primeras Contribuciones
+
+|<img alt="GitKraken" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-icon.png" width="200">|GitKraken Edition|
+|---|---|
+
+Es difícil. Siempre es difícil cuando se hace algo por primera vez. Especialmente cuando se colabora, cometer errores no es algo agradable. Pero el código abierto trata sobre la colaboración y el trabajo en conjunto. Queríamos simplificar la manera en que los contribuyentes de código abierto aprenden y contribuyen por primera vez.
+
+Leer artículos y ver tutoriales puede ayudar, pero ¿qué es mejor que hacer las cosas sin estropear nada?. Este proyecto tiene como objetivo proporcionar orientación y simplificar la manera en que los novatos hacen su primera contribución. Recuerda que cuando más relajado estés, mejor aprenderás. Si buscas hacer tu primera contribución sólo sigue los simples pasos a continuación. Te lo prometemos, será divertido.
+
+## Git Kraken
+
+Descarga [GitKraken](https://www.gitkraken.com), Instálalo y ábrelo.
+
+Deberías ver el diálogo modal "Welcome to GitKraken" - Regístrate con Github y permite el acceso a Gitkraken a tu cuenta de GitHub.
+
+<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-login.png" alt="login to GitHub" />
+
+(opcional) Dirígete a File -> Preferences y configura el directorio de tu proyecto en la raíz de tus repositorios locales. 
+
+
+## Bifurca (Fork) este repositorio
+
+Bifurca este repositorio clickeando en el botón fork en la parte superior derecha de esta página.
+
+<img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/fork.png" alt="fork this repository" />
+Esto creará una copia de este repositorio en su cuenta.
+
+
+## Clona el repositorio
+
+En GitKraken, ve a File -> Clone Repo.
+
+
+<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-clone.png" alt="clone this repository" />
+
+
+Selecciona GitHub.com  en el panel derecho. Bajo tu nombre de usuario, deberías ver first-contributions. Haz click en ese repositorio y verifica la ruta completa mostrada al final del panel.
+
+Una vez estés satisfecho con la ruta, clickea "Clone the repo!".
+
+## Crear una rama (*branch*)
+
+Clickea el botón *branch* de la barra de herramientas.
+
+Nombra tu rama "add-your-name", por ejemplo: "add-william-sutton"
+
+<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-branch.png" alt="name your branch" />
+
+
+## Haz los cambios necesarios y confirma (*Commit*) esos cambios
+
+Ahora abre el archivo `Contributors.md` en un editor de texto y agrégale tu nombre, luego guarda el archivo.
+
+Si tienes el repositorio abierto en GitKraken deberías ver que hay cambios. Revisa y prepara esos cambios seleccionando la confirmación (*commit*) más reciente marcada con "// WIP" y el número de archivos cambiados y el tipo de cambio.
+
+<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-edit.png" alt="edit some file(s)" />
+
+Revisa los archivos que han sido cambiados y decide cuáles deseas preparar para confirmar (*stage*). La preparación es importante para decirle a git exactamente que archivos deseas asociar con esta confirmación (*commit*).
+
+
+<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-stage.png" alt="stage your changes" />
+
+Una vez tengas un buen mensaje de confirmación (*commit*) ("Add <your-name> to Contributors list" suena agradable y descriptivo) y estés feliz con tus cambios, puedes clickear "Stage all changes" para preparar todo lo modificado o "Stage File" para preparar un archivo individual.
+
+
+<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-commit.png" alt="clone this repository" />
+
+Si cambias de idea, puedes olvidar (*unstage*) esos cambios, o puedes descartárlos todos.
+ADVERTENCIA: Como lo implica la palabra descartar, esta es una operación destructiva. Hazlo solo si no quieres ningún cambio(s) desde cualquier repositorio en el que te encuentres.
+
+Clickea en *commit*.
+
+Felicidades, has confirmado (*committed*) todos los cambios a la copia local de la rama de tu bifurcación (*fork*) de first-contributions.¡Adelante!.
+
+## Sube (*push*) los cambios a GitHub
+
+<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-push.png" alt="push your changes" />
+
+Haz click en el botón *Push* en la barra de herramientas.
+
+<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-origin.png" alt="origin or branch" />
+
+Envía los cambios en la rama origen si quieres que los cambios se reflejen en la rama maestra directamente, sino selecciona la rama apropiada a la cual quieres hacer el push.
+
+## Envía tus cambios para revisión
+
+Si vas a tu repositorio en github, verás el botón `Compare & pull request`. Haz click en él.
+
+<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/compare-and-pull.png" alt="create a pull request" />
+
+Ahora confirma el pull request.
+
+<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/submit-pull-request.png" alt="submit pull request" />
+
+Pronto estaré fusionando todos sus cambios en la rama master de este proyecto. Recibirás una notificación por correo electrónico cuando los cambios hayan sido fusionados.
+
+## ¿Cuáles son los siguientes pasos?
+
+¡Enhorabuena! ¡Has completado el flujo de trabajo _fork -> clone -> edit -> PR_ que encontrarás habitualmente como contribuidor!
+
+Celebra tu contribución y compártela con tus amigos y seguidores yendo a [App web](https://firstcontributions.github.io/#social-share).
+
+También podrías unirte a nuestro equipo de Slack en caso de que necesites ayuda o tengas alguna pregunta. [Únete a nuestro equipo de Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
+
+
+### [Material adicional](../additional-material/git_workflow_scenarios/additional-material.md)
+
+
+## Tutoriales con otras herramientas
+[Regresar a la página principal](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
--- a/translations/Translations.md
+++ b/translations/Translations.md
@ -27,8 +27,7 @@
 | <img alt="日本語" title="日本語" src="https://cdn.staticaly.com/gh/hjnilsson/country-flags/master/svg/jp.svg" width="22">                                                                                                                                                         | [日本語](README.ja.md)                                                   |
 | <img alt="Tiếng Việt" title="Tiếng Việt" src="https://cdn.staticaly.com/gh/hjnilsson/country-flags/master/svg/vn.svg" width="22">                                                                                                                                           | [Tiếng Việt](README.vn.md)                                            |
 | <img alt="Polski" title="Polski" src="https://cdn.staticaly.com/gh/hjnilsson/country-flags/master/svg/pl.svg" width="22">                                                                                                                                                   | [Polski](README.pl.md)                                                |
-| <img alt="فارسی" title="فارسی" src="https://cdn.staticaly.com/gh/hjnilsson/country-flags/master/svg/ir.svg" width="22">                                                                                                                                                     | [فارسی](README.fa.md)                                                 |
-| <img alt="Persian_Finglish" title="Persian_Finglish" src="https://cdn.staticaly.com/gh/hjnilsson/country-flags/master/svg/ir.svg" width="22">                                                                                                                               | [Persian_Finglish](README.fa.en.md)                                   |
+| <img alt="فارسی" title="فارسی" src="https://cdn.staticaly.com/gh/hjnilsson/country-flags/master/svg/ir.svg" width="22">                                                                                                                                                     | [فارسی](README.fa.md)                                                 |                                  |
 | <img alt="Lietuvių kalba" title="Lietuvių kalba" src="https://cdn.staticaly.com/gh/hjnilsson/country-flags/master/svg/lt.svg" width="22">                                                                                                                                   | [Lietuvių kalba](README.lt.md)                                        |
 | <img alt="[한국어" title="[한국어" src="https://cdn.staticaly.com/gh/hjnilsson/country-flags/master/svg/kr.svg" width="22"> <img alt="[한국어" title="[한국어" src="https://cdn.staticaly.com/gh/hjnilsson/country-flags/master/svg/kp.svg" width="22">                                 | [한국어](README.ko.md)                                                   |
 | <img alt="Deutsch" title="Deutsch" src="https://cdn.staticaly.com/gh/hjnilsson/country-flags/master/svg/de.svg" width="22">                                                                                                                                                 | [Deutsch](README.de.md)                                               |