Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions src/content/contributor-docs/en/steward_guidelines.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -110,7 +110,7 @@ Bug report issues should use the "Found a bug" issue template. The following wor
* Otherwise, leave a comment about where the bug report should be filed (with a direct link provided) and close the issue.
* The first step in reviewing a bug report is to see if enough information is provided for a bug replication, and if so, attempt to replicate the bug as described.
2. If the bug can be replicated:
* Some discussion may be required to determine the best way to fix a particular bug. Sometimes, it may be straightforward; sometimes, it may be tricky. Please refer to [p5.js' design principles](../contributor_guidelines.md#software-design-principles) when making this decision on a case-by-case basis.
* Some discussion may be required to determine the best way to fix a particular bug. Sometimes, it may be straightforward; sometimes, it may be tricky. Please refer to [p5.js' design principles](../contributor_guidelines/#software-design-principles) when making this decision on a case-by-case basis.
* If the issue author indicated in the issue they are willing to contribute a fix:
* Approve the issue for fixing by the issue author by leaving a comment and assigning them to the issue. Use the cog button on the right side next to "Assignee".
* If the issue author does not wish to contribute a fix:
Expand All @@ -135,7 +135,7 @@ Feature request issues should use the "New Feature Request" issue template. The
* If a feature request does not have the "Increasing Access" field sufficiently filled out, you can ask the issue author how the feature increases access.
* The access statement of a feature can be provided by a different member of the community, including the issue reviewers.
2. The new feature request can be assessed for inclusion based on the following criteria.
* Does the feature fit into the project scope and [design principles](../contributor_guidelines.md#software-design-principles) of p5.js?
* Does the feature fit into the project scope and [design principles](../contributor_guidelines/#software-design-principles) of p5.js?
* For example, a request to add a new drawing primitive shape may be considered, but a request to adopt a browser-based IOT protocol will likely be out of scope.
* Overall, the scope of p5.js should be relatively narrow in order to avoid excessive bloat from rarely used features.
* If a feature does not fit into the scope of p5.js, suggest that the issue author implement the feature as an addon library.
Expand Down Expand Up @@ -233,7 +233,7 @@ Dependabot PRs are usually only visible to repo admins so if this does not apply

## Build process

This section will not cover the general build setup nor commands but rather details about what's happening behind the scenes. Please see the [contributor’s guidelines](../contributor_guidelines.md#working-on-p5js-codebase) for more detailed build info.
This section will not cover the general build setup nor commands but rather details about what's happening behind the scenes. Please see the [contributor’s guidelines](../contributor_guidelines/#working-on-the-p5js-codebase) for more detailed build info.

Starting with p5.js version 2.0, the project no longer uses Grunt for task automation. Instead, the build and test processes are handled using modern tools like npm scripts, ESLint, and [Vitest](https://vitest.dev/).

Expand Down
69 changes: 34 additions & 35 deletions src/content/contributor-docs/es/steward_guidelines.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,29 +12,28 @@ Ya sea que seas nuevo contribuyendo para p5.js, que seas activo en los repositor

## Tabla de Contenidos

* [Stewardship (Guía de Área)](#stewardship)
* [Cuidado de la Comunidad](#community-care)
* [Áreas](#areas)
* [Convertirse en Steward](#becoming-a-steward)
* [Comenzando como Steward](#getting-started-with-stewardship)
* [Issues](../steward_guidelines.md#issues)
* [Informe de Errores](../steward_guidelines.md#informe-de-errores)
* [Solicitud de Funcionalidades](../steward_guidelines.md#solicitud-de-funcionalidades)
* [Mejora de Funcionalidades](../steward_guidelines.md#mejora-de-funcionalidades)
* [Discusión](../steward_guidelines.md#discusión/)
* [Pull Requests](../steward_guidelines.md#pull-requests)
* [Corrección Sencilla](../steward_guidelines.md#correción-sencilla/)
* [Corrección de Error](../steward_guidelines.md#corrección-de-error/)
* [Nuevas Funcionalidades/Mejora de Funcionalidades](../steward_guidelines.md#nuevas-funcionalidades/Mejora-de-funcionalidades/)
* [Dependabot](../steward_guidelines.md#dependabot)
* [Proceso de Construcción](../steward_guidelines.md#proceso-de-construcción/)
* [Tarea Principal de Construcción](../steward_guidelines.md#tarea-principal-de-construcción/)
* [Tarea Variada](../steward_guidelines.md#tarea-variada)
* [Proceso de Lanzamiento](../steward_guidelines.md#proceso-de-lanzamiento)
* [Consejos y Trucos](../steward_guidelines.md#consejos-y-trucos)
* [Plantillas de Respuesta](../steward_guidelines.md#plantillas-de-respuesta)
* [GitHub CLI](../steward_guidelines.md#github-cli)
* [Gestión de Notificaciones](../steward_guidelines.md#gestión-de-notificaciones/)
* [Stewardship (Guía de Área)](#stewardship-rol-de-guía-de-área)
* [Cuidado de la Comunidad](#cuidado-de-la-comunidad)
* [Áreas](#áreas)
* [Convertirse en Steward](#convertirse-en-steward)
* [Comenzando como Steward](#comenzando-como-steward)
* [Issues](#issues)
* [Informe de Errores](#informe-de-errores)
* [Solicitud de Funcionalidades](#solicitud-de-funcionalidades)
* [Mejora de Funcionalidades](#mejora-de-funcionalidades)
* [Discusión](#discusión)
* [Pull Requests](#pull-requests)
* [Corrección Sencilla](#correción-sencilla)
* [Corrección de Error](#corrección-de-error)
* [Nuevas Funcionalidades/Mejora de Funcionalidades](#nuevas-funcionalidadesmejora-de-funcionalidades)
* [Dependabot](#dependabot)
* [Proceso de Construcción](#proceso-de-compilación)
* [Tarea Principal de Construcción](#tarea-principal-de-construcción)
* [Proceso de Lanzamiento](#proceso-de-lanzamiento)
* [Consejos y Trucos](#consejos-y-trucos)
* [Plantillas de Respuesta](#plantillas-de-respuesta)
* [GitHub CLI](#github-cli)
* [Gestión de Notificaciones](#gestión-de-notificaciones)

***

Expand Down Expand Up @@ -92,7 +91,7 @@ Para permanecer como steward, debes contribuir como steward en al menos 1 de los

### Comenzando como Steward

1. Mantén estas directrices a mano como referencia: cómo ayudar con nuevos issues, bugs y funcionalidades. Por ejemplo, la sección "Solicitud de Funcionalidades" incluye consejos sobre cómo usar la [declaración de acceso](../\[access.md]\(https://github.com/processing/p5.js/blob/dev-2.0/contributor_docs/es/access/\)) de p5.js como steward.
1. Mantén estas directrices a mano como referencia: cómo ayudar con nuevos issues, bugs y funcionalidades. Por ejemplo, la sección "Solicitud de Funcionalidades" incluye consejos sobre cómo usar la [declaración de acceso](../es/contribute/access/) de p5.js como steward.
2. Al ayudar a responder preguntas técnicas o revisar, intenta aplicar la [directriz de la Processing Foundation sobre cómo responder preguntas](https://discourse.processing.org/t/guidelines-answering-questions/2145). Estas pueden ser especialmente útiles para dar retroalimentación técnica constructiva.
3. Únete al [Discord de p5.js](https://discord.p5js.org). ¡En el canal `#contribute-to-p5` cualquier pregunta o propuesta de mejora sobre este proceso es bienvenida!

Expand All @@ -111,7 +110,7 @@ Los *issues* de informes de errores deberían utilizar la plantilla de *Issue* "
* De lo contrario, deje un comentario sobre dónde debería presentarse el informe de error (con un enlace directo proporcionado) y cierre el *issue*.
* El primer paso para revisar un informe de error es verificar si se proporciona suficiente información para replicar el error, y si es así, se debe intentar replicar el error según lo descrito.
2. Si el error se puede replicar:
* Puede ser necesario realizar alguna discusión para determinar la mejor manera de solucionar un error particular. Puede ser necesario realizar alguna discusión para determinar la mejor manera de solucionar un error particular. A veces, puede ser directo;otras veces, puede ser complicado. Por favor, consulte los [principios de diseño de p5.js](../design_principles/) al tomar esta decisión caso por caso.
* Puede ser necesario realizar alguna discusión para determinar la mejor manera de solucionar un error particular. Puede ser necesario realizar alguna discusión para determinar la mejor manera de solucionar un error particular. A veces, puede ser directo;otras veces, puede ser complicado. Por favor, consulte los [principios de diseño de p5.js](../es/contribute/contributor_guidelines/#software-design-principles) al tomar esta decisión caso por caso.
* Si el autor del *issue* indicó en el *issue* que está dispuesto a contribuir con una solución:
* Apruebe el *issue* para su solución por parte del autor del *issue* dejando un comentario y asignándoles el *issue*. Utilice el botón de engranaje en el lado derecho junto a "Assignee".
* Si el autor del *issue* no desea contribuir con una solución:
Expand All @@ -132,11 +131,11 @@ Los *issues* de informes de errores deberían utilizar la plantilla de *Issue* "

Los *issues* para solicitar funcionalidades deberían utilizar la plantilla "New Feature Request". El siguiente flujo de trabajo es típico para abordar las solicitudes de función:

1. Como parte del compromiso de p5.js de aumentar el acceso, una solicitud de función debe justificar cómo aumenta el acceso de p5.js a comunidades que históricamente han sido marginadas en el campo. Más detalles están disponibles [aquí](../access/).
1. Como parte del compromiso de p5.js de aumentar el acceso, una solicitud de función debe justificar cómo aumenta el acceso de p5.js a comunidades que históricamente han sido marginadas en el campo. Más detalles están disponibles [aquí](../es/contribute/access/).
* Si una solicitud de funcionalidad no tiene suficientemente completado el campo "Increasing Access" ("Aumento de Acceso"), puedes preguntar al autor del *issue* cómo la funcionalidad aumenta el acceso.
* La declaración de acceso de una funcionalidad puede ser proporcionada por un miembro diferente de la comunidad, incluidos los revisores de *issue*.
2. Una nueva solicitud de funcionalidad puede ser evaluada para su inclusión en base a los siguientes criterios:
* ¿La función encaja en el alcance del proyecto y los principios de diseño [principios de diseño](../design_principles/) de p5.js?
* ¿La función encaja en el alcance del proyecto y los principios de diseño [principios de diseño](../es/contribute/contributor_guidelines/#software-design-principles) de p5.js?
* Por ejemplo, una solicitud para agregar una nueva forma primitiva de dibujo puede ser considerada, pero una solicitud para adoptar un protocolo de Internet de las cosas basado en el navegador probablemente estará fuera de alcance.
* En general, el alcance de p5.js debería ser relativamente estrecho para evitar un exceso de características poco utilizadas.
* Si una función no encaja en el alcance de p5.js, sugiere al autor del *issue* que implemente la función como una biblioteca complementaria.
Expand All @@ -153,7 +152,7 @@ Los *issues* para solicitar funcionalidades deberían utilizar la plantilla "New

Las solicitudes de *issues* de mejora de función deberían utilizar la plantilla de incidentes de "Existing Feature Enhancement" (Mejora de Funcionalidades Existentes). El proceso es muy similar a las solicitudes de nuevas funcionalidades. La diferencia entre una *new feature request* (solicitud de nueva funcionalidad) y una *feature request* (Mejora de Funcionalidad) puede ser confusa a veces. La mejora de función principalmente trata sobre las funcionalidades existentes de p5.js, mientras que una solicitud de nueva función podría estar solicitando la adición de funcionalidades completamente nuevas.

1. Similar a las solicitudes de nuevas funcionalidades, las mejoras de función solo deben ser aceptadas si aumentan el acceso a p5.js. Por favor, consulta el punto 1 de la [sección anterior](../steward_guidelines.md#feature-request).
1. Similar a las solicitudes de nuevas funcionalidades, las mejoras de función solo deben ser aceptadas si aumentan el acceso a p5.js. Por favor, consulta el punto 1 de la [sección anterior](../es/contribute/steward_guidelines/#feature-request).
2. Los criterios de inclusión para las mejoras de función son similares a los de las solicitudes de nuevas funcionalidades, pero se debe prestar especial atención a los posibles cambios incompatibles.
* Si se están modificando funcionalidades existentes, todas las firmas de funcionalidades válidas y documentadas previamente deben comportarse de la misma manera.
3. Las mejoras de funcionalidades deben ser aprobadas por al menos un supervisor o responsable de mantenimiento antes de que comience el trabajo hacia una *pull request*. El proceso de revisión de *pull request* para mejoras de funcionalidades está documentado a continuación.
Expand All @@ -173,7 +172,7 @@ Este tipo de *issue* tiene una plantilla mínima de discusión y debería ser ut
Casi todas las contribuciones de código a los repositorios de p5.js se realizan a través de Pull Request. Los supervisores y los responsables de mantenimiento pueden tener *push access* (acceso de escritura) a los repositorios, pero aún se les anima a seguir el mismo proceso de *issue* > *pull request* > proceso de revisión al contribuir con código. Aquí están los pasos para revisar una *pull request*:

* La plantilla de pull request se puede encontrar [Aquî](https://github.com/processing/p5.js/blob/main/.github/PULL_REQUEST_TEMPLATE.md).
* Casi todas las solicitudes de pull requests deben tener *issues* asociados abiertos y discutidos primero, lo que significa que los["flujos de trabajo de los *issues* mås relevantes ](../steward_guidelines.md#issues) deben haber sido seguidos primero antes de que una *pull request* sea revisada por cualquier supervisor o responsable de mantenimiento.
* Casi todas las solicitudes de pull requests deben tener *issues* asociados abiertos y discutidos primero, lo que significa que los["flujos de trabajo de los *issues* mås relevantes ](../es/contribute/steward_guidelines/#issues) deben haber sido seguidos primero antes de que una *pull request* sea revisada por cualquier supervisor o responsable de mantenimiento.
* Las únicas instancias donde esto no se aplica son correcciones muy menores de errores tipográficos, las cuales no requieren un *issue* abierto y pueden ser fusionadas por cualquier persona con acceso para aplicar *merge* (fusionar) al repositorio, incluso si no son supervisores de una área en particular.
* Si bien esta excepción existe, la aplicaremos en la práctica solo mientras se siga alentando a los contribuyentes a abrir nuevos *issues* primero. En otras palabras, si tienes dudas sobre si esta excepción se aplica, simplemente abre un *issue* de todos modos.
* Si una "pull request"no resuelve completamente el *issue* referenciado, puedes editar la publicación original y cambiar "Resolves #OOOO" a "Addresses #OOOO" para que no cierre automáticamente el *issue* original cuando la *pull request* aplique *merge* (se fusione).
Expand All @@ -189,7 +188,7 @@ Correcciones simples, como la corrección de un pequeño error tipográfico, pue

1. *Bug fixes* (Corrección de errores) deberían ser revisado por el supervisor del área relevante, idealmente el mismo que aprobó el *issue* referenciado para su corrección.
2. La pestaña "Files Changed" de la *pull request* se puede utilizar para revisar inicialmente si el *fix* (la ccorrección) se implementa según lo descrito en la discusión del *issue*.
3. La *pull request* Debería ser probada localmente siempre que sea posible y relevante. El GitHub CLI puede ayudar a agilizar parte del proceso. Ver más abajo en [Consejos y trucos](../steward_guidelines.md#tips-tricks).
3. La *pull request* Debería ser probada localmente siempre que sea posible y relevante. El GitHub CLI puede ayudar a agilizar parte del proceso. Ver más abajo en [Consejos y trucos](#consejos-y-trucos).
* [ ] La Corrección debe abordar suficientemente el *issue* original.
* [ ] La Corrección no debe cambiar ningún comportamiento existente a menos que se acuerde en el *issue* original.
* [ ] La Corrección no debe tener un impacto significativo en el rendimiento de p5.js.
Expand Down Expand Up @@ -228,7 +227,7 @@ Las *pull requests* de Dependabot generalmente solo son visibles para los admini

## Proceso de Compilación

Esta sección no cubrirá la configuración general de compilación (build) ni los comandos, sino más bien detalles sobre lo que sucede detrás de escena. Consulta las [directrices para administradores](../contributor_guidelines.md#working-on-p5js-codebase) para obtener información más detallada sobre la construcción.
Esta sección no cubrirá la configuración general de compilación (build) ni los comandos, sino más bien detalles sobre lo que sucede detrás de escena. Consulta las [directrices para administradores](../es/contribute/contributor_guidelines/#working-on-the-p5js-codebase/) para obtener información más detallada sobre la construcción.

A partir de la versión 2.0 de p5.js, el proyecto ya no usa Grunt para la automatización de tareas. En su lugar, los procesos de compilación y pruebas (test) se manejan usando herramientas modernas como scripts de npm, ESLint y [Vitest](https://vitest.dev/).

Expand Down Expand Up @@ -297,7 +296,7 @@ Nota: El proceso de compilación de Browserify/Grunt (por ejemplo, `browserify`,

## Proceso de Lanzamiento

Consulta [release\_process.md](../release_process/).
Consulta [release\_process.md](../es/contribute/release_process/).

***

Expand Down Expand Up @@ -329,13 +328,13 @@ A continuación, se muestran algunas de las Respuestas Guardadas que están sien

##### Cerrando: Acceso

> No veo mucho interés en esta función, y no tenemos una explicación clara de cómo [amplía el acceso](../access/), así que cerraré esto por ahora. Si se puede agregar una declaración de acceso a la solicitud del <em>issue</em>, no dudes en volver a abrirlo.
> No veo mucho interés en esta función, y no tenemos una explicación clara de cómo [amplía el acceso](../es/contribute/access/), así que cerraré esto por ahora. Si se puede agregar una declaración de acceso a la solicitud del <em>issue</em>, no dudes en volver a abrirlo.

> No vemos una explicación más detallada de cómo esta cuestión [amplía el acceso](../access/), así que cerraré este <em>issue</em> por ahora. Si se puede agregar una declaración de acceso más detallada a la solicitud de función, no dudes en volver a abrirla. ¡Gracias!
> No vemos una explicación más detallada de cómo esta cuestión [amplía el acceso](../es/contribute/access/), así que cerraré este <em>issue</em> por ahora. Si se puede agregar una declaración de acceso más detallada a la solicitud de función, no dudes en volver a abrirla. ¡Gracias!

##### Cerrando: Complemento

> Creo que esta función está fuera del alcance de la API de p5.js (intentamos mantenerla lo más minimalista posible), pero podría ser un gran punto de partida para una biblioteca complementaria. Consulta la documentación aquí sobre cómo crear un complemento: [https://github.com/processing/p5.js/blob/main/contributor\_docs/creating\_libraries.md](../creating_libraries/)
> Creo que esta función está fuera del alcance de la API de p5.js (intentamos mantenerla lo más minimalista posible), pero podría ser un gran punto de partida para una biblioteca complementaria. Consulta la documentación aquí sobre cómo crear un complemento: [https://github.com/processing/p5.js/blob/main/contributor\_docs/creating\_libraries.md](../es/contribute/creating_libraries/).

##### Cerrando PR: Primero Necesita <em>Issue</em>

Expand Down
Loading
Loading