Skip to content

Commit 5473bc0

Browse files
committed
traduccion al ingles ultima parte
1 parent 7e5e73d commit 5473bc0

1 file changed

Lines changed: 37 additions & 35 deletions

File tree

AEET_2025/reproducible_science.qmd

Lines changed: 37 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1717,98 +1717,100 @@ The website also makes available other formats (e.g. PDF, Docx) as well as links
17171717
17181718
# Collaborative work in GitHub
17191719
1720-
Aunque Git y GitHub facilitan el control de versiones de nuestros proyectos individuales, su máxima potencialidad se despliega al trabajar en equipo ya que facilitan el seguimiento del trabajo de todos los colaboradores y la integración ordenada de cada parte en un producto final.
1720+
Although Git and GitHub make version control easier for our individual projects, their full potential is realized when working as a team, as they facilitate tracking each collaborator's work and the orderly integration of every part into a final product.
17211721
1722-
Para dar acceso de edición a tus colaboradores, en la página principal de nuestro proyecto en GitHub entramos en "*Settings -\> Access -\> Collaborators -\> Manage Access -\> Add people*". Los colaboradores pueden crear su copia local del proyecto de control de versiones clonando el repositorio remoto.
1722+
To give editing permission to your collaborators, go to the main page of your project on GitHub and navigate to "*Settings -> Access -> Collaborators -> Manage Access -> Add people*". Collaborators can create their own local copy of the version-controlled project by cloning the remote repository.
17231723
1724-
### 📝Ejercicio 2.1
1724+
### 📝Your turn
17251725
1726-
En equipos de 2 o 3 personas:
1726+
In teams of 2 or 3 people:
17271727
1728-
1. El dueño del repositorio invita al resto de integrantes del equipo a su proyecto
1729-
2. Los colaboradores clonan el repositorio al que han sido invitados a su directorio de trabajo
1728+
1. The repository owner invites the other team members to their project.
1729+
2. The collaborators clone the repository they have been invited to into their working directory.
17301730
17311731
## GitHub branches
17321732
1733-
Git permite crear una "rama" (*branch*) paralela al proyecto si se desea seguir una línea independiente de trabajo, bien por ser diferente de la principal (p. ej. probar un nuevo análisis) o bien para desarrollar específicamente una parte del proyecto (p. ej. trabajar sólo en la escritura de los métodos de un artículo mientras otros colaboradores trabajan en otras secciones). Las ramas permiten trabajar en el proyecto sin interferir con lo que están haciendo los compañeros. En Git, una rama es un *commit* al que se le da un nombre y que contiene un "enlace" (puntero o *pointer*) a un SHA específico que es el origen de la rama. La rama *main* es la rama por defecto cuando se crea un repositorio y a partir de ella se suelen crear las demás.
1733+
Git allows you to create a parallel "*branch*" in the project if you want to follow an independent line of work, either because it differs from the main one (e.g., testing a new analysis) or to specifically develop a part of the project (e.g., working only on writing the methods section of a paper while other collaborators work on different sections). Branches allow team members to work on the project without interfering with each other’s progress.
17341734
1735-
Las ramas se pueden generar en la [terminal](https://github.com/DatSciR/intro_git-github/blob/main/centra/dia2_colaboracion.md) y en la pestaña Git de RStudio. En la pestaña Git se generan mediante el botón "*New Branch*". Al lado de "*New Branch"* podemos observar todas las ramas que contiene el repositorio y nos permite cambiar de rama fácilmente clickando en ellas.
1735+
In Git, a branch is a *commit* that is given a name and contains a “link” (*pointer*) to a specific SHA, which is the origin of the branch. The *main* branch is the default branch when a repository is created, and it is typically the base from which other branches are created.
17361736
1737-
![Proceso de creación de la rama PPP y la rama monchi](images/ramas.png){fig-align="center"}
1737+
Branches can be created in the [terminal](https://github.com/DatSciR/intro_git-github/blob/main/centra/dia2_colaboracion.md) and in the Git tab of RStudio. In the Git tab, they are created using the "*New Branch"* button. Next to "*New Branch*", you can see all the branches in the repository, and it allows you to easily switch between them by clicking on them.
17381738
1739-
### 📝Ejercicio 2.2
1739+
![Creating process of "PPP" and "monchi" branches](images/ramas.png){fig-align="center"}
17401740
1741-
1. Un integrante del equipo crea una rama en el proyecto en el que colabora
1741+
### 📝Your turn
17421742
1743-
2. Modifica la primera frase del archivo README.txt y sube los cambios al repositorio remoto
1743+
1. A team member creates a branch in the project they’re collaborating on.
17441744
1745-
3. Vuelve a la rama main y comprueba el archivo README.txt
1745+
2. They modify the first sentence of the README.txt file and push the changes to the remote repository.
1746+
1747+
3. They switch back to the main branch and check the README.txt file.
17461748
17471749
![](images/github_code.png){fig-align="center" width="543"}
17481750
17491751
## How to merge different branches?
17501752
1751-
Cuando el trabajo desarrollado en una rama se da por finalizado hay que hacer la unión a la rama principal ("*main*"). Esto se puede hacer en la [terminal](https://github.com/DatSciR/intro_git-github/blob/main/centra/dia2_colaboracion.md) y con el botón "*pull request*" en la página del proyecto en GitHub siguiendo los pasos que se explican a continuación.
1753+
When the work developed in a branch is considered finished, it must be merged into the *main* branch. This can be done in the [terminal](https://github.com/DatSciR/intro_git-github/blob/main/centra/dia2_colaboracion.md) or using the "*pull request*" button on the project's GitHub page, following the steps outlined below.
17521754
1753-
![Proceso de creación y unión de ramas. Ejemplo de unión (merge) de la rama monchi a la rama main](images/merge.jpg)
1755+
![Process of creating and merging branches. Merge example of "monchi" branch in to "main" branch](images/merge.jpg)
17541756
1755-
Una vez que hemos realizado los cambios que queríamos en la rama y están subidos a GitHub (`git add` + `git commit` + `git push`), en GitHub aparece la opción de "Compare & pull request". Aquí se genera el *pull request* ("*Create pull request*") añadiendo un mensaje para saber lo que se está uniendo. GitHub os indicará si existen conflictos o no. Si no existen conflictos, podréis realizar el *pull request* sin problema y, si existen conflictos, hay que resolverlos manualmente.
1757+
Once we have been made the desired changes in the branch and pushed them to GitHub (`git add` + `git commit` + `git push`), GitHub will display the option "Compare & pull request". Now you can create the *pull request* ("*Create pull request*") and add a message to describe what is being merged. GitHub will indicate whether there are any conflicts. If there are no conflicts, you’ll be able to complete the pull request without issue; if there are conflicts, they must be resolved manually.
17561758
17571759
![](images/pullrequest1.jpg){fig-align="center"}
17581760
17591761
![](images/pullrequest1.1.jpg)
17601762
1761-
![Características del merge a realizar](images/pullrequest2.jpg){fig-align="center"}
1763+
![Merge characteristics](images/pullrequest2.jpg){fig-align="center"}
17621764
17631765
![](images/pullrequest3.jpg){fig-align="center"}
17641766
1765-
![Confirmacion y fin del proceso](images/pullrequest3.1.jpg){fig-align="center"}
1767+
![Merge confirmation and end of the merging process](images/pullrequest3.1.jpg){fig-align="center"}
17661768
17671769
## Resolving conflicts
17681770
1769-
Git puede encontrar conflictos al fusionar ramas que hay que arreglar manualmente (GitHub os indicará "Can't automatically merge"). Esto ocurrirá si en las dos ramas se han cambiado las mismas líneas de un archivo. Hay que generar el pull request y "*Resolve conflicts*".
1771+
Git may encounter conflicts when merging branches that must be resolved manually (GitHub will indicate this with "Can't automatically merge"). This happens when the same lines of a file have been modified in both branches. In this case, you need to create the pull request and click on "*Resolve conflicts*".
17701772
1771-
![Aparición de conflictos](images/cant_merge.png)
1773+
![Arisal of conflics](images/cant_merge.png)
17721774
1773-
![Resolución de conflictos](images/cant_merge2.png)
1775+
![Resolving conflicts](images/cant_merge2.png)
17741776
1775-
Git muestra dónde están los conflictos así:
1777+
Git will show where the conflicts are like this:
17761778
1777-
`<<<<<<código del main=======código de la rama a unir>>>>>>`
1779+
`<<<<<< main code ======= branch code to be merged >>>>>>`
17781780
17791781
![](images/cant_merge3.png)
17801782
1781-
Para solucionarlo hay que escoger los cambios de la rama principal o de la rama a unir según corresponda. Una vez solucionados, Git permite completar el *merge* (es decir, un nuevo *commit* que contendrá las ramas fusionadas). La mejor manera de evitar conflictos o por lo menos reducir su dificultad es realizar cambios pequeños y sincronizar frecuentemente con GitHub, y tener una comunicación fluida con los colaboradores.
1783+
In order to resolve it, you need to choose the changes from either the main branch or the branch being merged. Once resolved, Git allows you to complete the *merge* (i.e., a new *commit* that will contain the merged branches). The best way to avoid conflicts, or at least reduce their complexity, is to make small changes, sync frequently with GitHub, and maintain clear communication with your collaborators.
17821784
1783-
### 📝Ejercicio 2.3
1785+
### 📝Your turn
17841786
1785-
1. Un integrante del equipo modifica también la primera frase del archivo README.txt en la rama main y sube los cambios al repositorio remoto. Esta frase había sido previamente modificada en una rama en el ejercicio anterior.
1786-
2. Un integrante del equipo combina la rama del ejercicio anterior con la rama principal (*main*) del proyecto.
1787-
3. Resolved el conflicto (es decir, quedaos con los cambios que sirvan y subid los cambios al repositorio remoto).
1787+
1. One of the team members also modifies the first sentence of the README.txt file in the main branch and pushes the changes to the remote repository. This sentence had previously been modified in a branch during the previous exercise.
1788+
2. A team member merges the branch from the previous exercise with the project's *main* branch.
1789+
3. Resolve the conflict (i.e., keep the changes that are appropriate and push the resolved file to the remote repository).
17881790
1789-
💡[Aquí](https://github.com/DatSciR/intro_git-github/blob/main/centra/dia3_comandos.md) (en la sección de "Otros comandos útiles") podéis ver cómo borrar ramas y otros comandos útiles
1791+
💡[Here](https://github.com/DatSciR/intro_git-github/blob/main/centra/dia3_comandos.md) (in the "Otros comandos útiles" section - in Spanish) you can see how to delete branches and other useful commands.
17901792
17911793
# Useful Links
17921794
1793-
**Ciencia reproducible**
1795+
**Reproducible science (in Spanish)**
17941796
1795-
- [Ciencia reproducible: qué, por qué, cómo](https://github.com/ecoinfAEET/Reproducibilidad)
1797+
- [(Spanish) Ciencia reproducible: qué, por qué, cómo](https://github.com/ecoinfAEET/Reproducibilidad)
17961798
17971799
- [Ciencia reproducible y colaborativa con R, Git y GitHub (DatSciR)](https://github.com/DatSciR/intro_git-github)
17981800
1799-
**Control de versiones (Git)**
1801+
**Version control (Git)**
18001802
1801-
- [Manual de referencia de Git](https://git-scm.com/docs)
1803+
- [Git reference manual](https://git-scm.com/docs)
18021804
18031805
- [Oh Shit, Git!?!](https://ohshitgit.com/)
18041806
1805-
- [git - la guía sencilla](https://rogerdudler.github.io/git-guide/index.es.html)
1807+
- [git - la guía sencilla (Spanish)](https://rogerdudler.github.io/git-guide/index.es.html)
18061808
18071809
- [Pro Git](https://git-scm.com/book/es/v2)
18081810
18091811
- [Happy Git and GitHub for the useR](https://happygitwithr.com/)
18101812
1811-
- [¡Se puede entender cómo funcionan Git y GitHub!](https://www.revistaecosistemas.net/index.php/ecosistemas/article/view/2332)
1813+
- [¡Se puede entender cómo funcionan Git y GitHub! (Spanish)](https://www.revistaecosistemas.net/index.php/ecosistemas/article/view/2332)
18121814
18131815
**Quarto**
18141816

0 commit comments

Comments
 (0)