diff --git a/contributor_docs/es/contributor_guidelines.md b/contributor_docs/es/contributor_guidelines.md new file mode 100644 index 0000000000..0c348fd1b1 --- /dev/null +++ b/contributor_docs/es/contributor_guidelines.md @@ -0,0 +1,272 @@ +# Instrucciones para colaboradores + +¡Bienvenidos! Este documento está diseñado para ayudar a nuevos contribuidores que deseen aportar código a la biblioteca de p5.js, así como a aquellos que busquen refrescar sus conocimientos sobre procedimientos técnicos. También es útil para cualquier persona interesada en realizar cualquier tipo de contribución al código de p5.js. + +Si estás buscando contribuir más allá de los repositorios de p5.js (escribiendo tutoriales, planeando clases, organizando eventos), por favor consulta la documentación correspondiente para este tipo de colaboraciones. Aquellos que sean Supervisores o Responsables de mantenimiento, encontrarán más útil referirse a las [Instrucciones para Supervisores](https://github.com/processing/p5.js/blob/main/contributor_docs/es/steward_guidelines.md) cuando se trata de revisar 'Issues' (problemas) y 'Pull Requests'. + +Este es un documento relativamente largo e integral, pero trataremos de indicar todos los pasos tan claro como sea posible. Utiliza la tabla de contenidos para encontrar las secciones que son relevantes para ti, y siéntete libre de omitir secciones que no son relevantes para las contribuciones que planeas hacer. + +**Si eres un nuevo contribuidor te sugerimos comenzar con la primera sección: “Todo acerca de los 'Issues' (o problemas)”. Si simplemente quieres una configuración paso-a-paso del proceso de desarrollo, puedes dirigirte a la sección de “Inicio Rápido para Desarrolladores”.** + + +# Tabla de Contenidos + +- [Todo acerca de los 'Issues' o problemas](#todo-acerca-de-los-issues-o-problemas) + - [¿Qué son los 'Issues' en GitHub?](#qué-son-los-issues-en-github) + - [Plantillas para reportar 'Issues'](#plantillas-para-reportar-issues) + - [Reportar un error](#reportar-un-error) + - [Sugerir una mejora a una funcionalidad existente](#sugerir-una-mejora-a-una-funcionalidad-existente) + - [Sugerir una funcionalidad nueva](#sugerir-una-funcionalidad-nueva) + - [Abrir una discusión ](#abrir-una-discusión) +- [Trabajando en la base de código de p5.js](#trabajando-en-la-base-de-código-de-p5js) + - [Inicio Rápido para Desarrolladores](#inicio-rápido-para-desarrolladores) + - [Utilizando la funcionalidad de edición de Github](#utilizando-la-funcionalidad-de-edición-de-github) + - [Haciendo un fork de p5.js y trabajando desde tu fork](#haciendo-un-fork-de-p5js-y-trabajando-desde-tu-fork) + - [Utilizando Github Desktop](#utilizando-github-desktop) + - [Utilizando la interfaz de línea de comandos de Git](#utilizando-la-interfaz-de-línea-de-comandos-de-git) + - [Desglose de la base de código ](#desglose-de-la-base-de-código) + - [Configuración de compilación](#configuración-de-compilación) + - [Flujo de trabajo de Git](#flujo-de-trabajo-de-git) + - [Código fuente](#código-fuente) + - [Pruebas unitarias](#pruebas-unitarias) + - [Documentación en línea](#documentación-en-línea) + - [Internacionalización](#internacionalización) + - [Accesibilidad](#accesibilidad) + - [Estándares de código](#estándares-de-código) + - [Principios de Diseño de Software](#principios-de-diseño-de-software) +- [Pull Requests](#pull-requests) + - [Creación de un Pull Request](#creación-de-un-pull-request) + - [Información sobre el Pull Request](#información-sobre-el-pull-request) + - [Titulo](#titulo) + - [Resuelve](#resuelve) + - [Cambios](#cambios) + - [Captura de pantalla de los cambios](#captura-de-pantalla-de-los-cambios) + - [Lista de verificación del Pull Request](#lista-de-verificación-del-pull-request) + - [Rebase y resolución de conflictos](#rebase-y-resolución-de-conflictos) + - [Discutir y Corregir](#discutir-corregir) + +--- +# Todo acerca de los “Issues” o problemas + +La mayoría de la actividad en los repositorios de GitHub de p5.js (también conocidos como "repo" de forma abreviada) ocurre en los 'Issues', o problemas, lo cual es un excelente lugar para comenzar tu viaje de contribución. + + +## ¿Qué son los "Issues" en GitHub? + +![A cropped screenshot of the p5.js library GitHub repository, only showing contents of the top right corner. A red box is drawn on top of the screenshot surrounding the Issues tab.](../images/issues-tab.png) + +'Issues' es el nombre común que se le da a una publicación en GitHub que apunta a describir, como lo dice su nombre, un problema. Los Issues pueden ser reportes de error, solicitudes para añadir un nueva funcionalidad, una discusión, o cualquier publicación que se relacione con el desarrollo de la biblioteca de p5.js. Cualquiera con una cuenta de GitHub puede añadir comentarios debajo de cada Issue, ¡incluyendo bots! Este es el lugar donde los contribuidores discuten temas relacionados con el desarrollo del proyecto dentro del repositorio. + +Mientras un Issue puede ser creado por diferentes razones, usualmente utilizamos la creación de un Issue para discutir el desarrollo del código fuente de p5.js. Temas como la corrección de errores de tu propio código, invitación de colaboradores a tu proyecto, u otros temas no relacionados, deben ser discutidos ya sea en el [foro](https://discourse.processing.com) o en otras plataformas de comunicación como [Discord](https://discord.gg/SHQ8dH25r9). + +¡Hemos creado plantillas fáciles de usar que puede ayudarte a determinar si un tema es adecuado para ser publicado como un Issue en GitHub, o si sería más apropiado publicarlo en otro lugar! + + +## Plantillas para reportar "Issues" +Las plantillas para reportar Issues en p5.js hacen que sea más sencillo para los Supervisores y los responsables de mantenimiento entender y revisar el contenido sugerido por el colaborador. Además, las plantillas le facilitan al colaborador el proceso de completar un Issue y, así mismo, le permiten recibir una respuesta más rápida. + +![Screenshot of an example of what an issue looks like on GitHub. The title of the issue in the screenshot is "Warning being logged in Safari when using a filter shader in 2D mode #6597"](../images/github-issue.png) + +Para registrar un Issue por primera vez dentro del repositorio de p5.js, haz click en la pestaña que dice "Issues", ubicada en la parte superior. Una vez dentro de la página de "Issues" haz clic en el botón "New Issue" (problema nuevo), que se encuentra al costado derecho. Se te presentarán diferentes opciones de plantilla que te van a dirigir al lugar adecuado para registrar tu Issue. Te recomendamos elegir la plantilla más relevante para tu caso para asegurarte de que tu Issue reciba rápidamente la atención correcta. + +![Cropped screenshot of the GitHub repository's issue page with the green "New issue" button highlighted with a red box surrounding it.](../images/new-issue.png) + +### ["Reportar un Error"](https://github.com/processing/p5.js/issues/new?assignees=\&labels=Bug\&projects=\&template=found-a-bug.yml) + +Cuando encuentres un comportamiento incorrecto en p5.js, o algo que no se esté comportando como se ha descrito en la documentación, [usa esta plantilla]( https://github.com/processing/p5.js/issues/new?assignees=&labels=Bug&projects=&template=found-a-bug.yml). Por favor, ten en cuenta que si estás tratado de corregir el código de tu sketch (boceto), y crees que el problema tal vez se encuentra en tu código, primero consulta en el [foro de discusiones]( https://discourse.processing.org/) antes de reportar un error. + +Esta plantilla provee campos que debes llenar con la siguiente información relevante: + +1. **¿Cuál es la subárea más adecuada de p5.js?:** esto añadirá automáticamente las [etiquetas]( https://github.com/processing/p5.js/blob/main/contributor_docs/issue_labels.md) relevantes a tu Issue, lo que nos ayudará a identificar y responder adecuadamente. +2. **Versión de p5.js:** Puedes verificar la versión de p5.js dentro de la etiqueta `