Usar la interfaz de usuario de Github para Hacer Solicitudes de Extracción

From Joomla! Documentation

This page is a translated version of the page Using the Github UI to Make Pull Requests and the translation is 78% complete.

Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎Nederlands
Tutorial

Este artículo te ayuda a comprender y crear Solicitudes de Extracción en Github, así que puedes contribuir a un proyecto como el de Joomla!.

Some changes though are "substantial", and we ask that these be put through a bit of a design process and produce a consensus among the community and the core team.

Before making a pull request

A hastily proposed pull request can hurt its chances of acceptance. Low quality proposals, proposals for previously rejected features, may be quickly rejected, which can be demotivating for the unprepared contributor. Laying some groundwork ahead of the pull request can make the process smoother.

Although there is no single way to prepare for submitting a pull request, it is generally a good idea to pursue feedback from other project developers beforehand to ascertain that the pull request may be desirable. Although it may seem like a useful feature or bug fix, there may be reasons it cannot work that you have not considered (or could not know about).

As a rule of thumb, receiving encouraging feedback from long-standing project developers, and particularly members of the core team or existing contributors, is a good indication that the pull request is worth pursuing. To get feedback, we suggest you join the Volunteers Portal and join Glip to ask other developers. Once you are ready, we suggest, before doing any code, you submit an issue to the Joomla! issue tracker with "RFC" at the beginning. That will create a request for comments which will help you to identify any additional work or issues you may have to overcome to get your idea accepted.

¿Qué es una Solicitud de Extracción?

Un Solicitud de Extracción es una solicitud para que seextraiga un poco de código a un repositorio (proyecto) en GitHub.

En lenguaje básico te estás preguntando si algún cambio/adición de código que hayas realizado se pueden utilizar en el proyecto. Este cambio puede ser la solución a un error o una nueva característica. Github tiene una interfaz web simple que hace que sea muy fácil proponer un simple cambio de código. No necesitas instalar ningún software o hacer otra cosa además de registrarse para tener una cuenta github.


Identificar el cambio que te gustaría a hacer

Primero de todo, señala qué cambios te gustaría hacer.

Por ejemplo, nos gustaría añadir un icono en el bloque información de artículo, antes que el nombre de los autores. En el momento de la escritura, este icono aún no aparece.

Infoblock before.png

Encontrar el archivo que deseas modificar en Github

Si no tienes una cuenta de GitHub aú, regístrate en GitHub. Es gratis y muy fácil de hacer. Después de eso, ve al Repositorio del CMS de Joomla! y busca el archivo que deseas editar. Puedes navegar haciendo clic sobre la carpeta y nombre del archivo.

Este puede ser un paso duro a veces, porque Joomla! cuenta con más de 6000 archivos. En nuestro ejemplo tenemos que editar el siguiente archivo: /layouts/joomla/content/info_block/author.php.

Github joomlacms.png

Hacer los cambios

Navega hasta el archivo y edita el archivo haciendo clic en el icono del lápiz en la derecha.

En nuestro ejemplo, tenemos que añadir el siguiente código a la línea 14 del archivo: autor.php

<span class="icon-user"></span>

Github filechange.png

Nota: puedes haber notado el mensaje de fondo azul de arriba de la página. Este mensaje es para decirte que GitHub hizo una copia del proyecto para ti, donde puedes hacer cambios. Esta copia se llama Bifurcación. Los cambios realizados en esta copia pueden ser utilizadod en el proyecto original. Si quieres leer más acerca de cómo trabaja GitHub, puedes leer este artículo en inglés para alguna información de los antecedentes.


Añadir un título y una descripción

A continuación del editor, podemos especificar nuestra Solicitud de Extracción mediante la adición de un título y una descripción.

El título debe ser corto, y debe decir que hace esta solicitud de extracción.

La descripción contiene información más detallada acerca de la solicitud de Extracción y alguna información de cómo probarlo. Redacta esta información de manera tan completa y clara como sea posible. Cuando realizas una Solicitud de Extracción de un problema en GitHub, es muy común añadir también el ID DEL problema en la descripción. Puedes hacer esto escribiendo un # (hash tag) seguido directamente con el ID del problema. Puedes encontrar este ID directamente después del título del tema, en la misma anotación.

Github description.png


Enviar la Solicitud de Extracción

Has clic en el botón "Proponer los cambios en el archivo" y después en el botón "Crear Solicitud de Extracción". ¡Tu solicitud de extracción se realiza ahora!

Create pull request.PNG


¿Y ahora?

Lo único que tienes que hacer ahora es esperar hasta que alguien ponga a prueba este PR. Cuando alguien hace un comentario, serás notificado a través de un correo electrónico. Puede suceder que alguien solicite información adicional, así que trata de mantenerse al día con tu Solicitud de Extracción.

Si una Solicitud de Extracción es probado con éxito en dos ocasiones, un moderador va a añadir la etiqueta 'RTC'. RTC significa: Listo Para Usar. En lenguaje básico se le dice a alguien que se utilizado correctamente: Esta solicitud de Extracción fue probada con éxito y puede ser añadida a Joomla!. La administración agregad (Mezcla) con el proyecto del repositorio del CMS de Joomla! en github. Tu Solicitud de Extracción es definitiva ahora y estará presente en la próxima versión de Joomla! si era sobre la solución de un error o en la próxima versión de menor importancia si el PR se acerca una nueva característica.