From 6431319b572c6b024ec8c8de74dc9b0b791344d6 Mon Sep 17 00:00:00 2001 From: Diana Galindo Date: Fri, 15 Mar 2024 10:41:25 +0000 Subject: [PATCH 01/15] contributor guidelines es --- contributor_docs/es/contributor_guidelines.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 contributor_docs/es/contributor_guidelines.md diff --git a/contributor_docs/es/contributor_guidelines.md b/contributor_docs/es/contributor_guidelines.md new file mode 100644 index 0000000000..e69de29bb2 From d227f35d26be340e8202f58eab2c0f92e3828d93 Mon Sep 17 00:00:00 2001 From: Diana Galindo Date: Fri, 15 Mar 2024 13:38:21 +0000 Subject: [PATCH 02/15] Intro and Table of Contents translation --- contributor_docs/es/contributor_guidelines.md | 63 +++++++++++++++++++ 1 file changed, 63 insertions(+) diff --git a/contributor_docs/es/contributor_guidelines.md b/contributor_docs/es/contributor_guidelines.md index e69de29bb2..fe4de4a64f 100644 --- a/contributor_docs/es/contributor_guidelines.md +++ b/contributor_docs/es/contributor_guidelines.md @@ -0,0 +1,63 @@ +## From the beginning all up to "Using Github desktop" +# 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 dirígete a 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/steward_guidelines.md) cuando se trata de revisar problemas ( ‘issues’) y “pull requests”. + +Este es un documento relativamente largo pero comprensible, y trataremos de indicar todos los pasos tan claro como sea posible. Sin embargo, 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)”. Por el contrario, si simplemente quieres un paso-a-paso del la configuración 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](#all-about-issues) + - [¿Qué son los ‘Issues’ en GitHub?](#what-are-issues) + - [Plantillas para reportar un 'issue'](#issue-templates) + - [Reportar un error](#found-a-bug) + - [Sugerir una mejora a una funcionalidad existente](#existing-feature-enhancement) + - [Sugerir una funcionalidad nueva](#new-feature-request) + - [Abrir una discusión ](#discussion) +- [Trabajando en la base de código de p5.js](#working-on-the-p5js-codebase) + - [Inicio Rápido para Desarrolladores](#quick-get-started-for-developers) + - [Utilizando la funcionalidad de edición de Github](#using-the-github-edit-functionality) + - [Haciendo un fork de p5.js y trabajando desde tu fork](#forking-p5js-and-working-from-your-fork) + - [Utilizando Github Desktop](#using-github-desktop) + - [Utilizando la interfaz de línea de comandos de git](#using-the-git-command-line-interface) + - [Desglose de la base de código ](#codebase-breakdown) + - [Configuración de compilación](#build-setup) + - [Flujo de trabajo de Git](#git-workflow) + - [Código fuente](#source-code) + - [Pruebas unitarias](#unit-tests) + - [Documentación en línea](#inline-documentation) + - [Internacionalización](https://github.com/processing/p5.js/blob/main/contributor_docs/contributor_guidelines.md#internationalization) + - [AcAccesibilidad](#accessibility) + - [Estándares de código](#code-standard) + - [Principios de Diseño de Software](#software-design-principles) +- [Pull Requests o Solicitudes de extracción](#pull-requests) + - [Creación de un Pull Request](#creating-a-pull-request) + - [Información sobre el Pull Request](#pull-request-information) + - [Titulo](#title) + - [Resuelve ](#resolves) + - [Cambios](#changes) + - [Captura de pantalla de los cambios](#screenshots-of-the-change) + - [Lista de verificación del ‘Pull Request’](#pr-checklist) + - [Rebase y Resolución de conflictos](#rebase-and-resolve-conflicts) + - [Discutir y Corregir](#discuss-and-amend) + +--- +# Todo acerca de los “Issues” o problemas + +The majority of the activity on p5.js' GitHub repositories (repo for short) happens in issues, which is a great place to start your contribution journey. + + +## ¿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) + +Un ‘Issue’ 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. El problema puede ser un reporte de error, una solicitud 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 puede añadir comentarios debajo de cada problema, incluyendo bots! Éste es el lugar donde los contribuidores discuten temas relacionados con el desarrollo del proyecto dentro del repositorio. + +Mientras un problema puede ser creado por diferentes razones, usualmente utilizamos la creación de un problema 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 [fórum](https://discourse.processing.com) o en otras plataformas de comunicación como [Discord](https://discord.gg/SHQ8dH25r9). + +Hemos desarrollado una plantilla fácil de usar que puede ayudarte a determinar si un tema es adecuado para ser publicado como un problema en GitHub, o si sería más apropiado publicarlo en otro lugar. From 18314a484c20ba2ca333c1d9421d7e682e76a350 Mon Sep 17 00:00:00 2001 From: Diana Galindo Date: Sat, 16 Mar 2024 11:31:52 +0000 Subject: [PATCH 03/15] Intro and Table of Content translation --- contributor_docs/es/contributor_guidelines.md | 31 +++++++++---------- 1 file changed, 15 insertions(+), 16 deletions(-) diff --git a/contributor_docs/es/contributor_guidelines.md b/contributor_docs/es/contributor_guidelines.md index fe4de4a64f..fad551ee2d 100644 --- a/contributor_docs/es/contributor_guidelines.md +++ b/contributor_docs/es/contributor_guidelines.md @@ -1,20 +1,19 @@ -## From the beginning all up to "Using Github desktop" # 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 dirígete a 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/steward_guidelines.md) cuando se trata de revisar problemas ( ‘issues’) y “pull requests”. +Si estás buscando contribuir más allá de los repositorios de p5.js (escribiendo tutoriales, planeando clases, organizando eventos), por favor dirígete a 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/steward_guidelines.md) cuando se trata de revisar 'Issues' (problemas) y 'Pull Requests'. Este es un documento relativamente largo pero comprensible, y trataremos de indicar todos los pasos tan claro como sea posible. Sin embargo, 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)”. Por el contrario, si simplemente quieres un paso-a-paso del la configuración del proceso de desarrollo, puedes dirigirte a la sección de “ Inicio Rápido para Desarrolladores.** +**Si eres un nuevo contribuidor te sugerimos comenzar con la primera sección: “ Todo acerca de los Issues (o problemas)”. Por el contrario, si simplemente quieres un paso-a-paso del la configuración 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](#all-about-issues) - - [¿Qué son los ‘Issues’ en GitHub?](#what-are-issues) - - [Plantillas para reportar un 'issue'](#issue-templates) +- [Todo acerca de los 'Issues' o problemas](#all-about-issues) + - [¿Qué son los 'Issues' en GitHub?](#what-are-issues) + - [Plantillas para reportar un 'Issue'](#issue-templates) - [Reportar un error](#found-a-bug) - [Sugerir una mejora a una funcionalidad existente](#existing-feature-enhancement) - [Sugerir una funcionalidad nueva](#new-feature-request) @@ -24,7 +23,7 @@ Este es un documento relativamente largo pero comprensible, y trataremos de indi - [Utilizando la funcionalidad de edición de Github](#using-the-github-edit-functionality) - [Haciendo un fork de p5.js y trabajando desde tu fork](#forking-p5js-and-working-from-your-fork) - [Utilizando Github Desktop](#using-github-desktop) - - [Utilizando la interfaz de línea de comandos de git](#using-the-git-command-line-interface) + - [Utilizando la interfaz de línea de comandos de Git](#using-the-git-command-line-interface) - [Desglose de la base de código ](#codebase-breakdown) - [Configuración de compilación](#build-setup) - [Flujo de trabajo de Git](#git-workflow) @@ -32,32 +31,32 @@ Este es un documento relativamente largo pero comprensible, y trataremos de indi - [Pruebas unitarias](#unit-tests) - [Documentación en línea](#inline-documentation) - [Internacionalización](https://github.com/processing/p5.js/blob/main/contributor_docs/contributor_guidelines.md#internationalization) - - [AcAccesibilidad](#accessibility) + - [Accesibilidad](#accessibility) - [Estándares de código](#code-standard) - [Principios de Diseño de Software](#software-design-principles) -- [Pull Requests o Solicitudes de extracción](#pull-requests) +- [Pull Requests](#pull-requests) - [Creación de un Pull Request](#creating-a-pull-request) - [Información sobre el Pull Request](#pull-request-information) - [Titulo](#title) - [Resuelve ](#resolves) - [Cambios](#changes) - [Captura de pantalla de los cambios](#screenshots-of-the-change) - - [Lista de verificación del ‘Pull Request’](#pr-checklist) - - [Rebase y Resolución de conflictos](#rebase-and-resolve-conflicts) + - [Lista de verificación del Pull Request](#pr-checklist) + - [Rebase y resolución de conflictos](#rebase-and-resolve-conflicts) - [Discutir y Corregir](#discuss-and-amend) --- # Todo acerca de los “Issues” o problemas -The majority of the activity on p5.js' GitHub repositories (repo for short) happens in issues, which is a great place to start your contribution journey. +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', 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) +![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) -Un ‘Issue’ 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. El problema puede ser un reporte de error, una solicitud 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 puede añadir comentarios debajo de cada problema, incluyendo bots! Éste es el lugar donde los contribuidores discuten temas relacionados con el desarrollo del proyecto dentro del repositorio. +'Issue' 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! Éste es el lugar donde los contribuidores discuten temas relacionados con el desarrollo del proyecto dentro del repositorio. -Mientras un problema puede ser creado por diferentes razones, usualmente utilizamos la creación de un problema 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 [fórum](https://discourse.processing.com) o en otras plataformas de comunicación como [Discord](https://discord.gg/SHQ8dH25r9). +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 [fórum](https://discourse.processing.com) o en otras plataformas de comunicación como [Discord](https://discord.gg/SHQ8dH25r9). -Hemos desarrollado una plantilla fácil de usar que puede ayudarte a determinar si un tema es adecuado para ser publicado como un problema en GitHub, o si sería más apropiado publicarlo en otro lugar. +¡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! From c0a98b02e52f932743c3dce76f5cb66acb74ab63 Mon Sep 17 00:00:00 2001 From: Diana Galindo Date: Sat, 16 Mar 2024 11:36:52 +0000 Subject: [PATCH 04/15] Intro and Table of Content translation --- contributor_docs/es/contributor_guidelines.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contributor_docs/es/contributor_guidelines.md b/contributor_docs/es/contributor_guidelines.md index fad551ee2d..9d948e6368 100644 --- a/contributor_docs/es/contributor_guidelines.md +++ b/contributor_docs/es/contributor_guidelines.md @@ -48,14 +48,14 @@ Este es un documento relativamente largo pero comprensible, y trataremos de indi --- # 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', lo cual es un excelente lugar para comenzar tu viaje de contribución. +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) -'Issue' 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! Éste es el lugar donde los contribuidores discuten temas relacionados con el desarrollo del proyecto dentro del repositorio. +'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! Éste 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 [fórum](https://discourse.processing.com) o en otras plataformas de comunicación como [Discord](https://discord.gg/SHQ8dH25r9). From 687db343fc33b0adc729876cedcc62473a696810 Mon Sep 17 00:00:00 2001 From: Diana Galindo Date: Sat, 16 Mar 2024 12:28:25 +0000 Subject: [PATCH 05/15] Intro and Table of Content translation --- contributor_docs/es/contributor_guidelines.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/contributor_docs/es/contributor_guidelines.md b/contributor_docs/es/contributor_guidelines.md index 9d948e6368..9e402b6d2f 100644 --- a/contributor_docs/es/contributor_guidelines.md +++ b/contributor_docs/es/contributor_guidelines.md @@ -60,3 +60,6 @@ La mayoría de la actividad en los repositorios de GitHub de p5.js (también con 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 [fórum](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 un 'Issue? \ No newline at end of file From 6f7efef82adfb4269efc81ea076a35cd87da1ef6 Mon Sep 17 00:00:00 2001 From: Diana Galindo Date: Sun, 17 Mar 2024 14:52:06 +0000 Subject: [PATCH 06/15] Issues template translation to spanish --- contributor_docs/es/contributor_guidelines.md | 129 +++++++++++++++++- 1 file changed, 127 insertions(+), 2 deletions(-) diff --git a/contributor_docs/es/contributor_guidelines.md b/contributor_docs/es/contributor_guidelines.md index 9e402b6d2f..79d7913ba7 100644 --- a/contributor_docs/es/contributor_guidelines.md +++ b/contributor_docs/es/contributor_guidelines.md @@ -13,7 +13,7 @@ Este es un documento relativamente largo pero comprensible, y trataremos de indi - [Todo acerca de los 'Issues' o problemas](#all-about-issues) - [¿Qué son los 'Issues' en GitHub?](#what-are-issues) - - [Plantillas para reportar un 'Issue'](#issue-templates) + - [Plantillas para reportar 'Issues'](#issue-templates) - [Reportar un error](#found-a-bug) - [Sugerir una mejora a una funcionalidad existente](#existing-feature-enhancement) - [Sugerir una funcionalidad nueva](#new-feature-request) @@ -62,4 +62,129 @@ Mientras un Issue puede ser creado por diferentes razones, usualmente u ¡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 un 'Issue? \ No newline at end of file +## 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, 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 `