sosokker/first-contributions
1
0
Fork 0
mirror of https://github.com/Sosokker/first-contributions.git synced 2025-12-20 13:44:05 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity

Merge branch 'main' into adarsh

Browse Source
This commit is contained in:
Roshan Jossy 2023-05-16 01:21:09 +02:00 committed by GitHub
commit f10d7a2662
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
4 changed files with 230 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
Contributors.md
View File

@ -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)
@ -387,7 +403,7 @@ chani-israel
- [solankybasant](https://github.com/solankybasant)
- [Ahmad Bilesanmi](https://github.com/bilesanmiahmad)
- [Pan Gong] (https://github.com/panda022)
- [Pan Gong] (https://github.com/panda022)
- [Brandon Cole](https://github.com/realbcole)
- [Koninika Tarafdar](https://github.com/Koninikax)
- [Karthikeyan Nambivinayagam](https://github.com/Karthikn-n)
@ -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)

85
additional-material/translations/amending-a-commit.fa.md Normal file
View File

@ -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 <اسم-شاخه>
```
تمام شد. الان هر دو تغییر در یک کامیت ثبت شده اند.

116
gui-tool-tutorials/translations/gitkraken-tutorial-es.md Normal file
View File

@ -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)

3
translations/Translations.md
View File

@ -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) |