folder names

1-getting-started-lessons/2-github-basics/.github/post-lecture-quiz.md

@@ -0,0 +1,19 @@
+*Complete this quiz by checking one answer per question.*
+
+1. A place to compare and discuss the differences introduced on a branch with reviews, comments, integrated tests, and more is:
+
+- [ ] GitHub
+- [ ] A Pull Request
+- [ ] A feature branch
+
+2. How would you get all the commits from a remote branch?
+
+- [ ] `git fetch`
+- [ ] `git pull`
+- [ ] `git commits -r`
+
+3. How do you switch to a branch?
+   
+- [ ] `git switch [branch-name]`
+- [ ] `git checkout [branch-name]`
+- [ ] `git load [branch-name]`

1-getting-started-lessons/2-github-basics/.github/pre-lecture-quiz.md

@@ -0,0 +1,13 @@
+*Complete this quiz in class*
+
+1. How do you create a Git repo?
+
+- [ ] git create
+- [ ] git start
+- [ ] git init
+
+2. What does `git add` do?
+
+- [ ] Commits your code
+- [ ] Adds your files to a staging area for tracking
+- [ ] Adds your files to GitHub

1-getting-started-lessons/2-github-basics/README.md

@@ -0,0 +1,292 @@
+# Introduction to GitHub
+
+This lesson covers the basics of GitHub, a platform to host and manage changes to your code.
+
+![Intro GitHub](images/webdev101-github.png)
+> Sketchnote by [Tomomi Imura](https://twitter.com/girlie_mac)
+
+
+## [Pre-lecture quiz](.github/pre-lecture-quiz.md)
+
+### Introduction
+
+In this lesson, we'll cover:
+
+- tracking the work you do on your machine
+- working on projects with others
+- how to contribute to open source software
+
+### Prerequisites
+
+Before you begin, you'll need to check if Git is installed. In the terminal type: 
+`git --version`
+
+If Git is not installed, [download Git](https://git-scm.com/downloads). Then, setup your local Git profile in the terminal:
+`git config --global user.name "your-name"`
+`git config --global user.email "your-email"`
+
+To check if Git is already configured you can type:
+`git config --list`
+
+You'll also need a GitHub account, a code editor (like Visual Studio Code), and you'll need to open your terminal (or: command prompt).
+
+Navigate to [github.com](https://github.com/) and create an account if you haven't already, or log in and fill out your profile. 
+
+✅ GitHub isn't the only code repository in the world; there are others, but GitHub is the best known
+
+### Preparation
+
+You'll need both a folder with a code project on your local machine (laptop or PC), and a public repository on GitHub, which will serve as an example for how to contribute to the projects of others.  
+
+---
+
+## Code management
+
+Let's say you have a folder locally with some code project and you want to start tracking your progress using git - the version control system. Some people compare using git to writing a love letter to your future self. Reading your commit messages days or weeks or months later you'll be able to recall why you made a decision, or "rollback" a change - that is, when you write good "commit messages".
+
+### Task: Make a repository and commit code
+
+1. **Create repository on GitHub**. On GitHub.com, in the repositories tab, or from the navigation bar top-right, find the **new repo** button.
+
+   1. Give your repository (folder) a name
+   1. Select **create repository**.
+
+1. **Navigate to your working folder**. In your terminal, switch to the folder (also known as the directory) you want to start tracking. Type:
+
+   ```bash
+   cd [name of your folder]
+   ```
+
+1. **Initialize a git repository**. In your project type:
+
+   ```bash
+   git init
+   ```
+
+1. **Check status**. To check the status if your repository type:
+
+   ```bash
+   git status
+   ```
+
+   the output can look something like this:
+
+   ```output
+   Changes not staged for commit:
+   (use "git add <file>..." to update what will be committed)
+   (use "git checkout -- <file>..." to discard changes in working directory)
+
+        modified:   file.txt
+        modified:   file2.txt
+   ```
+
+   Typically a `git status` command tells you things like what files are ready to be _saved_ to the repo or has changes on it that you might want to persist.
+
+1. **Add files to tracking**
+
+   ```bash
+   git add .
+   ```
+
+   The `git add` plus `.` argument indicates that all your files & changes for tracking.
+
+1. **Persisting your work**. At this point you've added the files to a so called _staging area_. A place where Git is tracking your files. To make the change permanent you need to _commit_ the files. To do so you create a _commit_ with the `git commit` command. A _commit_ represents a saving point in the history of your repo. Type the following to create a _commit_:
+
+   ```bash
+   git commit -m "first commit"
+   ```
+
+   This commits all of your files, adding the message "first commit". For future commit messages you will want to be more descriptive in your description to convey what type of change you've made.
+
+1. **Connect your local Git repo with GitHub**. A Git repo is good on your machine but at some point you want to have backup of your files somewhere and also invite other people to work with you on your repo. One such great place to do so is GitHub. Remember we've already created a repo on GitHub so the only thing we need to do is to connect our local Git repo with GitHub. The command `git remote add` will do just that. Type the following command:
+
+   > Note, before you type the command go to your GitHub repo page to find the repository URL. You will use it in the below command. Replace `repository_name` with your GitHub URL.
+
+   ```bash
+   git remote add origin https://github.com/username/repository_name.git
+   ```
+
+   This creates a _remote_, or connection, named "origin" pointing at the GitHub repository you created earlier.
+
+1. **Send local files to GitHub**. So far you've created a _connection_ between the local repo and the GitHub repo. Let's send these files to GitHub with the following command `git push`, like so: 
+
+   ```bash
+   git push -u origin main
+   ```
+
+   This sends your commits in your "main" branch to GitHub.
+
+1. **To add more changes**. If you want to continue making changes and pushing them to GitHub you’ll just need to use the following three commands:
+
+   ```bash
+   git add .
+   git commit -m "type your commit message here"
+   git push
+   ```
+
+   > Tip, You might also want to adopt a `.gitignore` file to prevent files you don't want to track from showing up on GitHub - like that notes file you store in the same folder but has no place on a public repository. You can find templates for `.gitignore` files at [.gitignore templates](github.com/github/gitignore).
+
+#### Commit messages
+
+A great Git commit subject line completes the following sentence:
+If applied, this commit will <your subject line here>
+
+For the subject use the imperative, present tense: "change" not "changed" nor "changes". 
+As in the subject, in the body (optional) also use the imperative, present tense. The body should include the motivation for the change and contrast this with previous behavior. You're explaining the `why`, not the `how`.
+
+✅ Take a few minutes to surf around GitHub. Can you find a really great commit message? Can you find a really minimal one? What information do you think is the most important and useful to convey in a commit message?
+
+### Task: Collaborate
+
+The main reason for putting things on GitHub was to make it possible to collaborate with other developers.
+
+## Working on projects with others
+
+In your repository, navigate to `Insights > Community` to see how your project compares to recommended community standards.
+
+   Here are some things that can improve your GitHub repo:
+   - **Description**. Did you add a description for your project?
+   - **README**. Did you add a README? GitHub provides guidance for writing a [README](https://docs.github.com/articles/about-readmes/).
+   - **Contributing guideline**. Does your project have [contributing guidelines](https://docs.github.com/articles/setting-guidelines-for-repository-contributors/), 
+   - **Code of Conduct**. a [Code of Conduct](https://docs.github.com/articles/adding-a-code-of-conduct-to-your-project/), 
+   - **License**. Perhaps most importantly, a [license](https://docs.github.com/articles/adding-a-license-to-a-repository/)?
+
+
+All these resources will benefit onboarding new team members. And those are typically the kind of things new contributors look at before even looking at your code, to find out if your project is the right place for them to be spending their time.
+
+✅ README files, although they take time to prepare, are often neglected by busy maintainers. Can you find an example of a particularly descriptive one? Note: there are some [tools to help create good READMEs](https://www.makeareadme.com/) that you might like to try.
+
+### Task: Merge some code
+
+Contributing docs help people contribute to the project. It explains what types of contributions you're looking for and how the process works. Contributors will need to go through a series of steps to be able to contribute to your repo on GitHub:
+
+
+1. **Forking your repo** You will probably want people to _fork_ your project. Forking means creating a replica of your repository on their GitHub profile.
+1. **Clone**. From there they will clone the project to their local machine. 
+1. **Create a branch**. You will want to ask them to create a _branch_ for their work. 
+1. **Focus their change on one area**. Ask contributors to concentrate their contributions on one thing at a time - that way the chances that you can _merge_ in their work is higher. Imagine they write a bug fix, add a new feature, and update several tests - what if you want to, or can only implement 2 out of 3, or 1 out of 3 changes?
+
+✅ Imagine a situation where branches are particularly critical to writing and shipping good code. What use cases can you think of?
+
+> Note, be the change you want to see in the world, and create branches for your own work as well. Any commits you make will be made on the branch you’re currently “checked out” to. Use `git status` to see which branch that is.
+
+Let's go through a contributor workflow. Assume the contributor has already _forked_ and _cloned_ the repo so they have a Git repo ready to be worked on, on their local machine:
+
+1. **Create a branch**. Use the command `git branch` to create a branch that will contain the changes they mean to contribute:
+
+   ```bash
+   git branch [branch-name]
+   ```
+
+1. **Switch to working branch**. Switch to the specified branch and update the working directory with `git checkout`:
+
+   ```bash
+   git checkout [branch-name]
+   ```
+
+1. **Do work**. At this point you want to add your changes. Don't forget to tell Git about it with the following commands:
+
+   ```bash
+   git add .
+   git commit -m "my changes"
+   ```
+
+   Ensure you give your commit a good name, for your sake as well as the maintainer of the repo you are helping on.
+
+1. **Combine your work with the `main` branch**. At some point you are done working and you want to combine your work with that of the `main` branch. The `main` branch might have changed meanwhile so make sure you first update it to the latest with the following commands:
+
+   ```bash
+   git checkout main
+   git pull
+   ```
+
+   At this point you want to make sure that any _conflicts_, situations where Git can't easily _combine_ the changes happens in your working branch. Therefore run the following commands:
+
+   ```bash
+   git checkout [branch_name]
+   git merge main
+   ```
+
+   This will bring in all changes from `main` into your branch and hopefully you can just continue. If not, VS Code will tell you where Git is _confused_ and you just alter the affected files to say which content is the most accurate.
+
+1. **Send your work to GitHub**. Sending your work to GitHub means two things. Pushing your branch to your repo and then open up a PR, Pull Request.
+
+   ```bash
+   git push --set-upstream origin [branch-name]
+   ```
+
+   The above command creates the branch on your forked repo.
+
+1. **Open a PR**. Next, you want to open up a PR. You do that by navigating to the forked repo on GitHub. You will see an indication on GitHub where it asks whether you want to create a new PR, you click that and you are taken to an interface where you can change commit message title, give it a more suitable description. Now the maintainer of the repo you forked will see this PR and _fingers crossed_ they will appreciate and _merge_ your PR. You are now a contributor, yay :)
+
+1. **Clean up**. It's considered good practice to _clean up_ after you. You want to clean up both your local branch and the branch you pushed to GitHub. First let's delete it locally with the following command: 
+
+   ```bash
+   git branch -d [branch-name]
+   ```
+
+   Ensure you go the GitHub page for the forked repo next and remove the remote branch you just pushed to it.
+
+`Pull request` seems like a silly term because really you want to push your changes to the project. But the maintainer (project owner) or core team needs to consider your changes before merging it with the project's "main" branch, so you're really requesting a change decision from a maintainer.  
+
+A pull request is the place to compare and discuss the differences introduced on a branch with reviews, comments, integrated tests, and more. A good pull request follows roughly the same rules as a commit message. You can add a reference to an issue in the issue tracker, when your work for instance fixes an issue. This is done using a `#` followed by the number of your issue. For example `#97`.
+
+🤞Fingers crossed that all checks pass and the project owner(s) merge your changes into the project🤞
+
+Update your current local working branch with all new commits from the corresponding remote branch on GitHub:
+
+`git pull`
+
+## How to contribute to open source
+
+First, let's find a repository - or: repo - on GitHub of interest to you and to which you'd like to contribute a change. You will want to copy the contents of to our machine.
+
+✅ A good way to find 'beginner-friendly' repos is to [search by the tag 'good-first-issue'](https://github.blog/2020-01-22-browse-good-first-issues-to-start-contributing-to-open-source/).
+
+![Copy a repo locally](/images/clone_repo.png)
+
+There are several ways of copying code. One way is to "clone" the contents of the repository, using HTTPS, SSH, or using the GitHub CLI (Command Line Interface). 
+
+Open your terminal and clone the repository like so:
+`git clone https://github.com/ProjectURL`
+
+To work on the project, switch to the right folder:
+`cd ProjectURL`
+
+You can also open the entire project using [Codespaces](https://github.com/features/codespaces), GitHub's embedded code editor / cloud development environment, or [GitHub Desktop](https://desktop.github.com/).
+
+Lastly, you can download the code in a zipped folder. 
+
+### A few more interesting things about GitHub
+
+You can star, watching, and/or "fork" any public repository on GitHub. You can find your starred repositories in the top-right drop-down menu. It's like bookmarking, but for code. 
+
+Projects have an issue tracker, mostly on GitHub in the "Issues" tab unless indicated otherwise, where people discuss issues related to the project. And the Pull Requests tab is where people discuss and review changes that are in progress.
+
+Projects might also have discussion in forums, mailing lists, or chat channels like Slack, Discord or IRC.
+
+✅ Take a look around your new GitHub repo and try a few things, like editing settings, adding information to your repo, and creating a project (like a Kanban board). There's a lot you can do!
+
+---
+
+## 🚀 Challenge 
+
+Pair with a friend to work on each other's code. Create a project collaboratively, fork code, create branches, and merge changes.
+
+## [Post-lecture quiz](.github/post-lecture-quiz.md)
+
+## Review & Self Study
+
+Read more about [contributing to open source software](https://opensource.guide/how-to-contribute/#how-to-submit-a-contribution). 
+
+[Git cheatsheet](https://training.github.com/downloads/github-git-cheat-sheet/).
+
+Practice, practice, practice. GitHub has great learning paths available via [lab.github.com](https://lab.github.com/):
+
+- [First Week on GitHub](https://lab.github.com/githubtraining/first-week-on-github)
+
+You'll also find more advanced labs. 
+
+## Assignment 
+
+Complete [the First Week on GitHub training lab](https://lab.github.com/githubtraining/first-week-on-github)

1-getting-started-lessons/2-github-basics/translations/README.es.md

@@ -0,0 +1,283 @@
+# Introducción a GitHub
+
+Esta lección cubre los conceptos básicos de GitHub, una plataforma para alojar y administrar cambios en su código.
+
+## [Pre-lecture prueba](.github/pre-lecture-quiz.md)
+
+### Introducción
+
+En esta lección, cubriremos:
+
+- seguimiento del trabajo que realiza en su máquina
+- trabajar en proyectos con otros
+- cómo contribuir al software de código abierto
+
+### Prerrequisitos
+
+Antes de comenzar, deberá verificar si Git está instalado. En el tipo de terminal:
+`git --version`
+
+Si Git no está instalado, [descargar Git](https://git-scm.com/downloads). Luego, configure su perfil de Git local en la terminal:
+`git config --global user.name "tu-nombre"`
+`git config --global user.email "tu-email"`
+
+Para comprobar si Git ya está configurado, puede escribir:
+`git config --list`
+
+También necesitará una cuenta de GitHub, un editor de código (como Visual Studio Code) y deberá abrir su terminal (o: símbolo del sistema).
+
+Vaya a [github.com](https://github.com/) y cree una cuenta si aún no lo ha hecho, o inicie sesión y complete su perfil.
+
+✅ GitHub no es el único repositorio de código del mundo; hay otros, pero GitHub es el más conocido.
+
+### Preparación
+
+Necesitará una carpeta con un proyecto de código en su máquina local (computadora portátil o PC) y un repositorio público en GitHub, que le servirá como ejemplo de cómo contribuir a los proyectos de otros.
+
+---
+
+## Gestión de código
+
+Digamos que tiene una carpeta localmente con algún proyecto de código y desea comenzar a rastrear su progreso usando git, el sistema de control de versiones. Algunas personas comparan el uso de git con escribir una carta de amor a su yo futuro. Al leer sus mensajes de confirmación días, semanas o meses después, podrá recordar por qué tomó una decisión o "revertir" un cambio, es decir, cuando escribe buenos "mensajes de confirmación".
+
+### Tarea: hacer un repositorio y enviar código
+
+1. **Crear repositorio en GitHub**. En GitHub.com, en la pestaña de repositorios, o en la barra de navegación superior derecha, busque el botón **nuevo repositorio**.
+
+    1. Dale un nombre a tu repositorio (carpeta)
+    1. Seleccione **crear repositorio**.
+
+1. **Navegue a su carpeta de trabajo**. En su terminal, cambie a la carpeta (también conocida como directorio) que desea comenzar a rastrear. Tipo:
+
+   ```bash
+   cd [nombre de tu carpeta]
+   ```
+
+1. **Inicializar un repositorio de git**. En su tipo de proyecto:
+
+   ```bash
+   git init
+   ```
+
+1. **Comprobar estado**. Para comprobar el estado de su tipo de repositorio:
+
+   ```bash
+   git status
+   ```
+
+   la salida puede verse así:
+
+   ```output
+   Changes not staged for commit:
+   (use "git add <file>..." to update what will be committed)
+   (use "git checkout -- <file>..." to discard changes in working directory)
+
+        modified:   file.txt
+        modified:   file2.txt
+   ```
+
+   Por lo general, un comando `git status` le dice cosas como qué archivos están listos para ser guardados en el repositorio o tiene cambios que es posible que desee conservar.
+
+1. **Agregar archivos al seguimiento**
+
+   ```bash
+   git add .
+   ```
+
+   El argumento `git add` más `.` indica que todos sus archivos y cambios para el seguimiento.
+
+1. **Persistir en tu trabajo**. En este punto, ha agregado los archivos a lo que se denomina _área de preparación_. Un lugar donde Git rastrea sus archivos. Para que el cambio sea permanente, debe _commitir_ los archivos. Para hacerlo, crea un _commit_ con el comando `git commit`. Un _commit_ representa un punto de ahorro en el historial de su repositorio. Escriba lo siguiente para crear un _commit_:
+
+   ```bash
+   git commit -m "first commit"
+   ```
+
+   Esto confirma todos sus archivos, agregando el mensaje "primer compromiso". Para futuros mensajes de confirmación, querrá ser más descriptivo en su descripción para transmitir qué tipo de cambio ha realizado.
+
+1. **Conecte su repositorio de Git local con GitHub**. Un repositorio de Git es bueno en su máquina, pero en algún momento desea tener una copia de seguridad de sus archivos en algún lugar y también invitar a otras personas a trabajar con usted en su repositorio. Un gran lugar para hacerlo es GitHub. Recuerde que ya hemos creado un repositorio en GitHub, por lo que lo único que debemos hacer es conectar nuestro repositorio de Git local con GitHub. El comando `git remote add` hará precisamente eso. Escriba el siguiente comando:
+
+
+   > Tenga en cuenta que antes de escribir el comando, vaya a la página de su repositorio de GitHub para encontrar la URL del repositorio. Lo usará en el siguiente comando. Reemplaza `repository_name` con tu URL de GitHub.
+
+
+   ```bash
+   git remote add origin https://github.com/username/repository_name.git
+   ```
+
+   Esto crea un _remote_, o conexión, llamado "origin" que apunta al repositorio de GitHub que creó anteriormente.
+
+1. **Envía archivos locales a GitHub**. Hasta ahora ha creado una _conexión_ entre el repositorio local y el repositorio de GitHub. Enviemos estos archivos a GitHub con el siguiente comando `git push`, así:
+ 
+
+   ```bash
+   git push -u origin main
+   ```
+
+   Esto envía sus confirmaciones en su rama "principal" a GitHub.
+
+1. **Para agregar más cambios**. Si desea continuar haciendo cambios y enviarlos a GitHub, solo necesitará usar los siguientes tres comandos:
+
+   ```bash
+   git add .
+   git commit -m "escribe tu mensaje de confirmación aquí"
+   git push
+   ```
+
+   > Sugerencia: es posible que también desee adoptar un archivo `.gitignore` para evitar que los archivos que no desea rastrear aparezcan en GitHub, como el archivo de notas que almacena en la misma carpeta pero no tiene lugar para escribir su mensaje de confirmación aquí repositorio público. Puede encontrar plantillas para archivos `.gitignore` en [.gitignore templates](github.com/github/gitignore).
+
+
+#### Confirmar mensajes
+
+Una gran línea de asunto de confirmación de Git completa la siguiente oración:
+Si se aplica, esta confirmación será <su línea de asunto aquí>
+
+Para el sujeto use el imperativo, tiempo presente: "cambiar" no "cambiar" ni "cambiar".
+Como en el sujeto, en el cuerpo (opcional) también use el imperativo, presente. El cuerpo debe incluir la motivación para el cambio y contrastarla con la conducta anterior. Estás explicando el "por qué", no el "cómo".
+
+✅ Tómate unos minutos para navegar por GitHub. ¿Puedes encontrar un mensaje de compromiso realmente bueno? ¿Puedes encontrar uno realmente mínimo? ¿Qué información crees que es la más importante y útil de transmitir en un mensaje de compromiso?
+
+### Tarea: Colaborar
+
+La razón principal para poner cosas en GitHub fue hacer posible la colaboración con otros desarrolladores.
+
+## Trabajando en proyectos con otros
+
+En su repositorio, vaya a `Insights > Community` para ver cómo se compara su proyecto con los estándares comunitarios recomendados.
+
+   Aquí hay algunas cosas que pueden mejorar su repositorio de GitHub:
+   - **Descripción**. ¿Agregaste una descripción para tu proyecto?
+   - **README**. ¿Agregaste un archivo README? GitHub proporciona una guía para escribir un [README](https://docs.github.com/articles/about-readmes/).
+   - **Pauta de contribución**. ¿Su proyecto tiene [pautas de contribución](https://docs.github.com/articles/setting-guidelines-for-repository-contributors/),
+   - **Código de Conducta**. un [Código de conducta](https://docs.github.com/articles/adding-a-code-of-conduct-to-your-project/),
+   - **Licencia**. Quizás lo más importante, una [licencia](https://docs.github.com/articles/adding-a-license-to-a-repository/)?
+
+Todos estos recursos beneficiarán la incorporación de nuevos miembros del equipo. Y esos son típicamente el tipo de cosas que los nuevos colaboradores miran antes incluso de mirar su código, para descubrir si su proyecto es el lugar adecuado para que ellos pasen su tiempo.
+
+✅ Los archivos README, aunque requieren tiempo para prepararse, a menudo son descuidados por los ocupados mantenedores. ¿Puede encontrar un ejemplo de uno particularmente descriptivo? Nota: hay algunas [herramientas para ayudar a crear buenos archivos READMEs](https://www.makeareadme.com/) que le gustaría probar.
+
+
+### Tarea: Fusionar código
+
+Los documentos que contribuyen ayudan a las personas a contribuir al proyecto. Explica qué tipos de contribuciones está buscando y cómo funciona el proceso. Los colaboradores deberán seguir una serie de pasos para poder contribuir a su repositorio en GitHub:
+
+1. **Bifurcando su repositorio** Probablemente querrá que la gente _bifurque_ su proyecto. Bifurcar significa crear una réplica de su repositorio en su perfil de GitHub.
+1. **Clonar**. Desde allí, clonarán el proyecto en su máquina local.
+1. **Crea una rama**. Querrá pedirles que creen una _ rama_ para su trabajo.
+1. **Concentre su cambio en un área**. Pida a los colaboradores que concentren sus contribuciones en una cosa a la vez; de esa manera, las posibilidades de que pueda _fusionar_ en su trabajo son mayores. Imagine que escriben una corrección de errores, agregan una nueva función y actualizan varias pruebas; ¿qué sucede si lo desea o solo puede implementar 2 de 3 o 1 de 3 cambios?
+
+✅ Imagine una situación en la que las sucursales son particularmente críticas para escribir y enviar un buen código. ¿En qué casos de uso se te ocurren?
+
+> Tenga en cuenta que sea el cambio que desea ver en el mundo y cree también sucursales para su propio trabajo. Todas las confirmaciones que realice se realizarán en la sucursal en la que está actualmente "registrado". Use `git status` para ver qué rama es esa.
+
+Repasemos el flujo de trabajo de un colaborador. Suponga que el colaborador ya ha _bifurcado_ y _clonado_ el repositorio para que tenga un repositorio de Git listo para trabajar en su máquina local:
+
+1. **Crea una rama**. Use el comando `git branch` para crear una rama que contendrá los cambios que pretenden contribuir:
+
+   ```bash
+   git branch [branch-name]
+   ```
+
+1. **Cambiar a rama de trabajo**. Cambie a la rama especificada y actualice el directorio de trabajo con `git checkout`:
+
+   ```bash
+   git checkout [branch-name]
+   ```
+
+1. **Trabaja**. En este punto, desea agregar sus cambios. No olvide informarle a Git con los siguientes comandos:
+
+   ```bash
+   git add .
+   git commit -m "mis cambios"
+   ```
+
+   Asegúrese de darle un buen nombre a su compromiso, por su bien y por el mantenedor del repositorio en el que está ayudando.
+
+1. **Combine su trabajo con la rama `principal`**. En algún momento ha terminado de trabajar y desea combinar su trabajo con el de la rama `principal`. La rama `main` podría haber cambiado mientras tanto, así que asegúrese de actualizarla primero a la última con los siguientes comandos:
+
+   ```bash
+   git checkout main
+   git pull
+   ```
+
+   En este punto, querrá asegurarse de que cualquier _conflicto_, situaciones en las que Git no pueda _combinarse_ fácilmente los cambios, ocurra en su rama de trabajo. Por lo tanto, ejecute los siguientes comandos:
+
+   ```bash
+   git checkout [branch_name]
+   git merge main
+   ```
+
+   Esto traerá todos los cambios de `main` a su rama y es de esperar que pueda continuar. De lo contrario, VS Code le dirá dónde está _confundido_ Git y simplemente modificará los archivos afectados para decir qué contenido es el más preciso.
+
+1. **Envíe su trabajo a GitHub**. Enviar tu trabajo a GitHub significa dos cosas. Empujar su sucursal a su repositorio y luego abrir un PR, Pull Request.
+
+   ```bash
+   git push --set-upstream origin [branch-name]
+   ```
+
+   El comando anterior crea la rama en su repositorio bifurcado.
+
+1. **Abra una PR**. A continuación, desea abrir un PR. Para hacerlo, navegue al repositorio bifurcado en GitHub. Verá una indicación en GitHub donde le preguntará si desea crear un nuevo PR, haga clic en eso y lo llevará a una interfaz donde puede cambiar el título del mensaje de confirmación, asígnele una descripción más adecuada. Ahora, el mantenedor del repositorio que bifurcó verá este PR y _dedos cruzados_ apreciarán y _ fusionar_ su PR. Ahora eres un colaborador, yay :)
+
+1. **Limpiar**. Se considera una buena práctica _limpiar_ después de ti. Desea limpiar tanto su sucursal local como la sucursal que envió a GitHub. Primero eliminémoslo localmente con el siguiente comando:
+
+   ```bash
+   git branch -d [branch-name]
+   ```
+
+   Asegúrese de ir a la página de GitHub para el repositorio bifurcado a continuación y elimine la rama remota que acaba de ingresar.
+
+`Solicitud de extracción` parece un término tonto porque realmente desea impulsar los cambios al proyecto. Pero el mantenedor (propietario del proyecto) o el equipo central debe considerar sus cambios antes de fusionarlo con la rama "principal" del proyecto, por lo que realmente está solicitando una decisión de cambio a un mantenedor.
+
+Una solicitud de extracción es el lugar para comparar y discutir las diferencias introducidas en una rama con revisiones, comentarios, pruebas integradas y más. Una buena solicitud de extracción sigue aproximadamente las mismas reglas que un mensaje de confirmación. Puede agregar una referencia a un problema en el rastreador de problemas, cuando su trabajo, por ejemplo, soluciona un problema. Esto se hace usando un '#' seguido del número de su problema. Por ejemplo, `#97`.
+
+🤞 Cruce los dedos para que todos los controles pasen y los propietarios del proyecto combinen sus cambios en el proyecto🤞
+
+Actualice su rama de trabajo local actual con todas las nuevas confirmaciones de la rama remota correspondiente en GitHub:
+
+`git pull`
+
+## Cómo contribuir al código abierto
+
+Primero, busquemos un repositorio (o: repositorio) en GitHub que le interese y al que le gustaría contribuir con un cambio. Querrá copiar el contenido de a nuestra máquina.
+
+✅ Una buena forma de encontrar repositorios 'aptos para principiantes' es [buscar por la etiqueta `buena-primera-edición`](https://github.blog/2020-01-22-browse-good-first-issues-para-empezar-a-contribuir-al-código-abierto/).
+
+Hay varias formas de copiar código. Una forma es "clonar" el contenido del repositorio, usando HTTPS, SSH o usando GitHub CLI (Interfaz de línea de comandos).
+
+Abra su terminal y clone el repositorio así:
+`git clone https://github.com/ProjectURL`
+
+Para trabajar en el proyecto, cambie a la carpeta correcta:
+`cd ProjectURL`
+
+También puede abrir todo el proyecto utilizando [Codespaces](https://github.com/features/codespaces), el entorno de desarrollo en la nube / editor de código integrado de GitHub o [GitHub Desktop](https://desktop.github.com/).
+
+Por último, puede descargar el código en una carpeta comprimida.
+
+### Algunas cosas más interesantes sobre GitHub
+
+Puede destacar, ver y / o "fork" cualquier repositorio público en GitHub. Puede encontrar sus repositorios destacados en el menú desplegable de la parte superior derecha. Es como marcar como favorito, pero por código.
+
+Los proyectos tienen un rastreador de problemas, principalmente en GitHub en la pestaña "Issues" a menos que se indique lo contrario, donde las personas debaten los problemas relacionados con el proyecto. Y la pestaña Solicitudes de extracción es donde las personas debaten y revisan los cambios que están en curso.
+
+Los proyectos también pueden tener discusiones en foros, listas de correo o canales de chat como Slack, Discord o IRC.
+
+✅ Eche un vistazo a su nuevo repositorio de GitHub y pruebe algunas cosas, como editar la configuración, agregar información a su repositorio y crear un proyecto (como un tablero Kanban). ¡Hay muchas cosas que puedes hacer!
+
+🚀 Desafío: empareje con un amigo para trabajar en el código del otro. Cree un proyecto de forma colaborativa, bifurque el código, cree ramas y combine los cambios.
+
+## [Post-lecture prueba](.github/post-lecture-quiz.md)
+
+## Revisión y autoestudio
+
+Obtenga más información sobre [contribución al software de código abierto](https://opensource.guide/how-to-contribute/#how-to-submit-a-contribution).
+
+[Hoja de referencia de Git](https://training.github.com/downloads/github-git-cheat-sheet/).
+
+Práctica práctica práctica. GitHub tiene excelentes rutas de aprendizaje disponibles a través de [lab.github.com](https://lab.github.com/):
+
+- [Primera semana en GitHub](https://lab.github.com/githubtraining/first-week-on-github)
+
+También encontrará laboratorios más avanzados.
+
+**Tarea**: Completa [la primera semana en el laboratorio de capacitación de GitHub](https://lab.github.com/githubtraining/first-week-on-github)