maven script interpreter

Contribuyendo al intérprete de scripts Apache Maven

¿Ha encontrado un error o tiene una idea para una característica nueva e interesante? Contribuir con código es una excelente manera de devolver algo a la comunidad de código abierto. Antes de profundizar en el código, hay algunas pautas que necesitamos que sigan los contribuyentes para que podamos tener la oportunidad de estar al tanto de todo.

Empezando

• Asegúrate de tener una cuenta JIRA.

• Asegúrate de tener una cuenta de GitHub.

• Si planea implementar una nueva característica, tiene sentido discutir sus cambios primero en la lista de desarrolladores. De esta manera, puede asegurarse de no perder el tiempo en algo que no se considera dentro del alcance de Apache Maven.

• Envíe un ticket para su problema, suponiendo que aún no exista uno.

• Describe claramente el problema, incluidos los pasos para reproducirlo cuando se trata de un error.

• Asegúrese de completar la versión más antigua que sepa que tiene el problema.

• Bifurca el repositorio en GitHub.

Realizar y enviar cambios

Aceptamos Pull Requests a través de GitHub. La lista de correo de desarrolladores es el principal canal de comunicación para los contribuyentes.
Hay algunas pautas que nos facilitarán la aplicación de las relaciones públicas:

• Crea una rama temática desde donde quieras basar tu trabajo (esta suele ser la rama maestra). Envíe sus cambios a una rama de tema en su bifurcación del repositorio.

• Realizar commits de unidades lógicas.

• Respete el estilo del código original: al usar el mismo estilo de código, los parches solo deben resaltar la diferencia real, sin verse afectados por ningún problema de formato:

• Utilice únicamente espacios para sangría.

• Cree diferencias mínimas: desactive las acciones al guardar, como reformatear el código fuente u organizar las importaciones. Si cree que se debe reformatear el código fuente, cree un PR separado para este cambio.

• Compruebe si hay espacios en blanco innecesarios con git diff --check antes de confirmar.

• Asegúrese de que sus mensajes de confirmación estén en el formato adecuado. Su mensaje de confirmación debe contener la clave del problema de JIRA.

[MSHARED-XXX] - Subject of the JIRA Ticket
 Optional supplemental description.

• Asegúrese de haber agregado las pruebas necesarias (JUnit/IT) para sus cambios.

• Ejecute todas las pruebas con mvn -Prun-its verify para asegurarse de que nada más se haya roto accidentalmente.

• Envíe una solicitud de extracción al repositorio de la organización Apache.

• Actualice su ticket JIRA e incluya un enlace a la solicitud de extracción en el ticket.

Si planea contribuir de forma regular, considere presentar un acuerdo de licencia de colaborador.

Hacer cambios triviales

Para cambios de naturaleza trivial en comentarios y documentación, no siempre es necesario crear un nuevo ticket en JIRA. En este caso, es apropiado comenzar la primera línea de una confirmación con '(doc)' en lugar de un número de ticket.

Recursos adicionales

• Contribuyendo con parches

• Página del proyecto de componentes compartidos de Apache Maven

• Acuerdo de licencia de colaborador

• Documentación general de GitHub

• Documentación de solicitud de extracción de GitHub

• Cuenta de Twitter de Apache Maven

• Canal IRC #Maven en freenode.org