Merge branch 'main' into main

2026-05-16 17:21:50 +00:00 · 2025-10-05 13:12:41 +02:00
parent 0fc14747a3 cbee1f4fe9
commit bfe1e97b7d
102 changed files with 4071 additions and 3946 deletions
@@ -0,0 +1,137 @@
+[![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/github-desktop-old-version-tutorial/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
+[![Licencia: MIT](https://img.shields.io/badge/Άδεια-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Contribuyentes 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="Git Bash" src="https://cdn.icon-icons.com/icons2/2699/PNG/512/git_scm_logo_icon_170096.png" width="200"> | Versión de Git Bash |
+| ------------------------------------------------------------------------------------------------------------------ | --------------------- |
+
+Es difícil. Siempre es difícil la primera vez que haces algo. Especialmente cuando colaboras, cometer errores puede ser incómodo. Pero el código abierto trata precisamente de colaboración y trabajo en conjunto. Queríamos simplificar el proceso mediante el cual nuevos colaboradores aprenden y hacen su primera contribución.
+
+Leer artículos y ver tutoriales en video puede ayudar, pero no hay nada como aprender haciendo sin temor a equivocarte. Este proyecto busca proporcionar una guía clara y sencilla para que principiantes hagan su primera contribución. Recuerda, cuanto más relajado estés, mejor aprenderás. Si estás buscando hacer tu primera contribución, simplemente sigue estos pasos. Te prometemos que será divertido.
+
+Si aún no tienes Git Bash en tu computadora con Windows, [descárgalo aquí](https://git-scm.com/download/win).
+
+<img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/fork.png" alt="haz un fork de este repositorio" />
+
+## Haz un fork de este repositorio
+
+Haz clic en el botón "Fork" en la esquina superior derecha de esta página para crear una copia de este repositorio en tu cuenta.
+
+## Clona tu repositorio
+
+Ahora clona ese repositorio en tu computadora.
+
+⚠️ IMPORTANTE: NO clones el repositorio original.
+
+Ve a tu fork y clónalo.
+
+Para hacerlo, haz clic en "Code" y copia el enlace.
+
+<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-1.png" alt="copiar enlace" />
+
+Abre la aplicación Git Bash que acabas de instalar. Debería lucir como la siguiente imagen si estás en Windows:
+
+<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-1.png" alt="abrir terminal de git bash" />
+
+Ve a la carpeta donde quieres guardar este proyecto usando el comando:
+
+`cd <carpeta>`
+
+<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-2.png" alt="entrar a la carpeta deseada" />
+
+Usa el enlace copiado anteriormente para clonar tu repositorio:
+
+`git clone <url-del-repositorio>`
+
+<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-2.png" alt="clonar repositorio" />
+
+Ve al directorio recién clonado y ábrelo en Visual Studio Code para hacer tus cambios.
+
+<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-3.png" alt="entrar al repo clonado" />
+
+## Crear una rama
+
+Ahora crea una nueva rama usando este comando:
+
+```
+git checkout -b <nombre-de-tu-rama>
+```
+
+Ejemplo: `add-james-smith`
+
+<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-branch.png" alt="crear rama" />
+
+## Realiza los cambios necesarios
+
+Abre el archivo `Contributors.md` en tu editor, ve al final del archivo y agrega tu nombre.
+
+Ejemplo:
+```md
+[James Smith](https://github.com/jamessmith)
+```
+
+Para verificar los cambios:
+
+```bash
+git status
+```
+
+<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-status.png" alt="ver estado" />
+
+Ahora haz commit de los cambios:
+
+Primero agrega el archivo:
+
+```bash
+git add Contributors.md
+```
+
+Después crea el commit:
+
+```bash
+git commit -m "Agrego mi nombre a la lista de contribuidores"
+```
+
+<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-commit.png" alt="commit de cambios" />
+
+Para verificar el commit:
+
+```bash
+git log --oneline
+```
+
+## Sube tus cambios a GitHub
+
+```bash
+git push origin <nombre-de-tu-rama>
+```
+
+<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-push.png" alt="hacer push" />
+
+## Envía tu Pull Request
+
+Ve a tu repositorio en GitHub. Verás un botón que dice “Compare & pull request”. Haz clic allí.
+
+<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/compare-and-pull.png" alt="crear pull request" />
+
+Completa el formulario y envía el Pull Request.
+
+<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/submit-pull-request.png" alt="enviar PR" />
+
+Pronto tus cambios serán revisados e integrados al repositorio principal. Recibirás una notificación por correo.
+
+## ¿Y ahora qué?
+
+¡Felicidades! Has completado el flujo de trabajo clásico _fork → clone → editar → pull request_ que es común en el mundo del open source.
+
+Celebra tu contribución compartiéndola con tus amigos o en redes. También puedes unirte al equipo en Slack para resolver dudas:  
+👉 [Únete al Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
+
+### [Material adicional](../additional-material/git_workflow_scenarios/additional-material.md)
+
+## Guías para otras herramientas
+
+[Volver a la página principal](https://github.com/firstcontributions/first-contributions/blob/main/translations/README.es.md#material-de-apoyo-para-otras-herramientas)
@@ -0,0 +1,142 @@
+[![Любов до Open Source](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/github-desktop-old-version-tutorial/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
+[![Ліцензія: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Помічники Open Source](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions)
+
+# Перші внески
+
+| <img alt="Git Bash" src="https://cdn.icon-icons.com/icons2/2699/PNG/512/git_scm_logo_icon_170096.png" width="200"> | Версія з Git Bash |
+| ------------------------------------------------------------------------------------------------------------------ | ----------------- |
+
+Це складно. Завжди складно робити щось уперше. Особливо, коли ви працюєте у команді — помилятися завжди некомфортно. Але open source — це саме про співпрацю та командну роботу. Ми хотіли спростити спосіб, у який новачки в open-source навчаються та роблять свій перший внесок.
+
+Читати статті й дивитися відеоуроки корисно, але немає нічого кращого, ніж спробувати на практиці без ризику щось зіпсувати. Цей проєкт має на меті зробити зрозумілий посібник і спростити спосіб, у який новачки роблять свій перший внесок. Пам’ятайте: чим спокійніше вам, тим краще ви навчаєтесь. Якщо ви хочете зробити свій перший внесок — просто дотримуйтесь інструкцій нижче. Обіцяємо — це буде весело!
+
+Якщо у вас немає Git Bash на Windows, [встановіть його](https://git-scm.com/download/win).
+
+<img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/fork.png" alt="fork this repository" />
+
+## Форкніть цей репозиторій
+
+Натисніть кнопку Fork у верхньому правому куті цієї сторінки.
+Це створить копію репозиторію у вашому акаунті.
+
+## Клонуйте репозиторій
+
+Тепер клонуйте репозиторій на ваш комп'ютер.
+
+ВАЖЛИВО: НЕ КЛОНУЙТЕ ОРИГІНАЛЬНИЙ РЕПОЗИТОРІЙ. Перейдіть до вашого форку і клонуте його.
+
+Щоб клонувати, натисніть на "Code" і скопіюйте запропонований рядок.
+
+<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-1.png" alt="copy string" />
+
+Відкрийте програму git bash, яку ви щойно встановили. Вона має виглядати як на наступній картинці, якщо ви використовуєте операційну систему Windows.
+
+<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-1.png" alt="open git bash terminal" />
+
+Перейдіть до папки, куди хочете зберегти проєкт, використовуючи наступну команду:
+
+```bash
+cd <папка>
+```
+
+<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-2.png" alt="cd into a folder" />
+
+Вставте скопійований раніше рядок і виконайте команду клонування:
+
+```bash
+git clone <url-репозиторію>
+```
+
+<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-2.png" alt="clone the repository" />
+
+Перейдіть у директорію репозиторію та відкрийте його у VS Code для редагування.
+
+<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-3.png" alt="cd into the newly cloned repo" />
+
+## Створіть гілку (branch)
+
+Використайте наступну просту команду для створення гілки. Ця команда не тільки створює нову гілку, а також переходить на цю гілку.
+
+```bash
+git checkout -b <назва-гілки>
+```
+
+Назвіть свою гілку у форматі `<add-your-name>`, наприклад: `add-james-smith`
+
+<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-branch.png" alt="create a branch" />
+
+## Зробіть необхідні зміни і зафіксуйте їх (commit)
+
+Відкрийте файл `Contributors.md` у текстовому редакторі, додайте ваше ім'я внизу сторінки і збережіть файл:
+
+Приклад: якщо ваше ім’я — James Smith, результат повинен виглядати так.
+
+\[James Smith](https://github.com/jamessmith)
+
+Перевірте зміни командою:
+
+```bash
+git status
+```
+
+<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-status.png" alt="check the status" />
+
+Зафіксуйте ці зміни:
+
+Спочатку додайте зміну, яку ви зробили, до області індексації (staging area), використовуючи команду:
+
+```bash
+git add ім'я_файлу
+```
+
+Потім напишіть повідомлення до коміту за допомогою цієї команди:
+
+```bash
+git commit -m "Add <ваше-ім'я> to Contributors list"
+```
+
+<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-commit.png" alt="commit changes" />
+
+Щоб перевірити історію комітів:
+
+```bash
+git log --oneline
+```
+
+## Відправте зміни на GitHub
+
+Коли ви завершите виконання наведених вище кроків, ви можете надіслати свої зміни за допомогою цієї команди:
+
+```bash
+git push origin <назва-гілки>
+```
+
+<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-push.png" alt="push changes" />
+
+## Надішліть запит для перевірки
+
+Перейдіть до вашого репозиторію на GitHub. Ви побачите кнопку "Compare & pull request". Натисніть її.
+
+<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/compare-and-pull.png" alt="create a pull request" />
+
+Після цього відправте pull request.
+
+<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/submit-pull-request.png" alt="submit pull request" />
+
+Незабаром ваші зміни буде об'єднано з основною гілкою проєкту. Ви отримаєте сповіщення електронною поштою після злиття вашої гілки з основною.
+
+## Що далі?
+
+Вітаємо! Ви щойно завершили стандартний процес: _fork -> clone -> edit -> PR_!
+
+Поділіться своєю участю з друзями або підпишіться на нашу спільноту [web app](https://firstcontributions.github.io#social-share).
+
+Приєднуйтесь до нашої Slack-групи, якщо у вас виникли питання або потрібна допомога: [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
+
+### [Додаткові матеріали](../additional-material/git_workflow_scenarios/additional-material.md)
+
+## Інструкції для інших інструментів
+
+[Повернутись на головну сторінку](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)