Obtención de comentarios sobre tu código por parte de GitHub Copilot

Acerca de la codificación en colaboración

Cuando trabajas con otros usuarios en GitHub, normalmente realizas los cambios en una rama o bifurcación del proyecto principal y, a continuación, los envías como una solicitud de incorporación de cambios. Una solicitud de incorporación de cambios muestra las diferencias entre el código original y tus cambios y le invita al mantenedor del repositorio a fusionar tu código en el proyecto.

Obtener comentarios sobre la solicitud de incorporación de cambios de otros usuarios es una parte importante del proceso de desarrollo de software. Las revisiones de solicitudes de incorporación de cambios mejoran el código específico en el que trabajas y también mejoran las aptitudes de codificación y colaboración a lo largo del tiempo. A veces, especialmente cuando aprendes a codificar, es posible que no siempre tengas que pedir comentarios a alguien. En esos casos, puede obtener comentarios y todas sus ventajas de GitHub Copilot en su lugar.

Una solicitud de incorporación de cambios es un lugar de colaboración donde puedes mostrar a otras personas los cambios que propones y obtener comentarios. Cuando solicite una revisión a Copilot, aprenderá el mismo proceso que usará cuando trabaje con equipos de desarrollo. La única diferencia es que también solicitará revisiones de personas junto con Copilot.

1. Creación del repositorio de prácticas

En este ejercicio, usarás un repositorio de ejemplo con código existente. El repositorio de ejemplo es new2code/grid-toy, un pequeño proyecto HTML y JavaScript que muestra una cuadrícula de cuadrados de cambio de color. Se trata de un sitio de GitHub Pages y puedes ver la versión original en https://new2code.github.io/grid-toy.

Para empezar, crea tu propia copia del repositorio grid-toy.

1. Ve a la página del nuevo repositorio. Al seguir este vínculo, se seleccionará previamente la plantilla en la cuenta new2code.
2. En "Propietario", selecciona la cuenta de usuario.
3. En el campo "Nombre del repositorio", escribe "grid-toy".
4. Haga clic en Create repository (Crear repositorio).

2. Realizar un cambio

A continuación, realizarás un cambio en el archivo JavaScript.

1. En el nuevo repositorio, haz clic en script.js en la lista de archivos.

2. Para editar el archivo de JavaScript, en la parte superior derecha, haz clic en .

3. En la línea 25, agrega el código siguiente:

   JavaScript

   if (Math.random() < INVERT_PROBABILITY) {
      cell.classes.add("black");
   }
   

   Este cambio establece algunos de los cuadrados de la cuadrícula aleatoriamente en negro cuando se carga la página. Hay un error deliberado para desencadenar comentarios de GitHub Copilot: la propiedad correcta es realmente .classList y no .classes. GitHub Copilot debería ayudarnos a corregirlo.

4. Para confirmar el cambio, en la parte superior derecha, haz clic en Confirmar cambios...

5. En el campo "Mensaje de confirmación", escriba algo parecido a "Configurar cuadrados aleatoriamente al cargar".

6. Seleccione Creación de una rama para esta confirmación e inicio de una solicitud de incorporación de cambios.

7. Haz clic en Proponer cambios.

3. Creación de una solicitud de incorporación de cambios y solicitud de revisión

Ahora completa la solicitud de incorporación de cambios y solicita una revisión.

1. Escribe un título y, opcionalmente, una descripción para la solicitud de incorporación de cambios.
2. Haz clic en Reviewers.
   • Si Copilot aparece en la lista sugerida, haga clic en "Copilot".
   • Si no es así, empiece a escribir "Copilot", haga clic en el resultado.
3. Haga clic en Crear solicitud de incorporación de cambios.

Se le redirigirá a su nueva solicitud de incorporación de cambios.

4. Aplicación de un cambio sugerido

En unos minutos, GitHub Copilot revisará la solicitud de incorporación de cambios, generará un resumen y creará cambios sugeridos para cualquier problema encontrado.

1. Espera a que aparezca la evaluación de GitHub Copilot.

2. Una de estas sugerencias debe corregir el error intencional anterior cambiando .classes a .classList. Debajo del cambio sugerido, haz clic en Commit suggestion.

   

3. Haga clic en Commit changes (Confirmar cambios).

4. Es posible que GitHub Copilot haya encontrado otras mejoras y deje comentarios adicionales. Si comprendes los cambios sugeridos, también puedes aplicarlos.

5. Combinación

Una vez que esté conforme con los cambios, puede combinar la solicitud de incorporación de cambios. Esto agrega los cambios de su rama a la rama predeterminada del repositorio (main).

1. En la parte inferior de la página, haz clic en Merge pull request.
2. Opcionalmente, actualiza el mensaje de confirmación.
3. Presiona Confirm merge.

Pasos siguientes

El proyecto se puede publicar con GitHub Pages. Ahora que has realizado algunos cambios, puedes publicar la versión del repositorio para verla en acción. Consulta Configuración de un origen de publicación para el sitio de GitHub Pages.