Pautas de Contribución

Siempre existirá la necesidad de que los desarrolladores nos ayuden a mejorar SpongeAPI. No existe tal cosa como un proyecto perfecto y las cosas siempre pueden ser mejoradas. Si eres un desarrollador y están interesado en ayudar entonces no lo dudes. Sólo asegurate de seguir nuestros lineamientos.

Nota

Los desarrolladores que muestren determinación y consistencia en sus contribuciones al proyecto serán invitados a unirse al Staff de Sponge por los Líderes de Equípo, a su discreción. No hay un proceso formal de postulación. Por favor, no pida ser parte del Staff, nosotros se lo pediremos.

Pasos Generales

1. Setup your workspace as described in Preparación del Desarrollo.

2. Asegúrate de estar familiarizado con Git y GitHub. Si necesitas refrescar tu conocimiento, echa un vistazo aquí Como usar Git(Hub)

3. Check for existing issues in the SpongeAPI, SpongeCommon and SpongeDocs repositories. There is possibly someone else already working on the same thing. You can also check issues marked with «help wanted» for existing issues we need your help with.

Nota

Please don’t submit pull requests for small, non-functional changes such as fixing typos or renaming variable names. Instead, you can:

• join #spongedev on IRC (irc.esper.net) and we’ll change it together with the other smaller changes.

• Join our Discord Server and post on the #dev channel. Discord and IRC are linked, so don’t worry. We won’t miss your message!

• You can also add it to our list of Minor Issues on GitHub.

4. If the issue requires a bigger change you may want to submit the issues without the necessary changes first, so we can confirm the issue and know that you’re working on fixing it. You should also create a draft pull request or comment with ~wip so we can already start reviewing them.

5. «Forkea» el proyecto, clónalo y realiza tus cambios en otra rama.

6. Prueba tus cambios (asegúrate de que compila!), comitea y pushea a tu fork,

7. Envía la solicitud de extracción con un pequeño sumario de lo que cambiaste y por qué debería cambiarse así.

8. Si haces cambios adicionales, envía nuevos commits a tu rama. No borres tus cambios, eso hace extremadamente difícil ver que cambiaste comparado con la versión anterior de tu solicitud de extracción.

9. Asegúrese de qué su PR esté actualizado según los últimos cambios de la marca a la cual tenga intención de incorporarlo. Si necesita ayuda para actualizarlo, sólo tiene que pedirla!

Truco

Si no estás seguro en qué rama deberías basar tu trabajo, lee sobre nuestro Repository Branch Layout antes de enviar tu PR.