Skip to content

Commit c27d374

Browse files
authored
Merge pull request #8310 from marioguzzzman/patch-2
Update Spanish steward guidelines for p5.js 2.x
2 parents 514df2a + e862686 commit c27d374

File tree

1 file changed

+63
-3
lines changed

1 file changed

+63
-3
lines changed

contributor_docs/es/steward_guidelines.md

Lines changed: 63 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,17 @@
11
<!-- Learn about how to manage and review contributions to p5.js. -->
22

3-
# Directrices para Supervisores
3+
# Directrices para Stewards (Guías de Área)
44

5-
6-
Ya sea que recién te hayas unido a nosotros como supervisor, seas un responsable de mantenimiento experimentado de p5.js, o estés en algún punto intermedio, esta guía contiene información, así como consejos y trucos que te ayudarán a contribuir de manera efectiva a p5.js. La mayor parte de lo que se escribe aquí son pautas a menos que se indique lo contrario, lo que significa que puedes adaptar las prácticas mostradas aquí para que se ajusten a tu flujo de trabajo.
5+
Ya sea que seas nuevo contribuyendo para p5.js, que seas activo en los repositorios de GitHub de p5.js, o que te encuentres en algún punto intermedio, encontrarás lo que necesitas en estas directrices sobre el rol de steward (guía de área) en p5.js. Si no estás seguro de qué esperar de los stewards, o si estás considerando ofrecerte como voluntario o comenzar como steward, ¡sigue leyendo!
76

87

98
## Tabla de Contenidos
109

10+
- [Stewardship (Guía de Área)](#stewardship)
11+
- [Cuidado de la Comunidad](#community-care)
12+
- [Áreas](#areas)
13+
- [Convertirse en Steward](#becoming-a-steward)
14+
- [Comenzando como Steward](#getting-started-with-stewardship)
1115
- [Issues](steward_guidelines.md#issues)
1216
- [Informe de Errores](steward_guidelines.md#informe-de-errores)
1317
- [Solicitud de Funcionalidades](steward_guidelines.md#solicitud-de-funcionalidades)
@@ -28,7 +32,63 @@ Ya sea que recién te hayas unido a nosotros como supervisor, seas un responsabl
2832
- [Gestión de Notificaciones](steward_guidelines.md#gestión-de-notificaciones)
2933

3034
---
35+
## Stewardship (Rol de Guía de Área)
36+
37+
### Cuidado de la Comunidad
38+
39+
Un ethos de código abierto incluye [accesibilidad, educación, colaboración, transparencia y agencia](https://www.opensourceethos.net/). Vivir y practicar estos valores mientras escribimos código juntos requiere un atento cuidado de la comunidad. Estas son las prácticas de cuidado comunitario que forman parte de nuestra definición de stewardship:
40+
41+
1. Dar la bienvenida a nuevos contribuidores en GitHub mediante **comentarios amigables** y **revisiones útiles de código**.
42+
2. Ayudar a **facilitar discusiones sobre funcionalidades** y resolver desacuerdos técnicos. Por ejemplo, hacer conexiones con otras discusiones u ofrecer aportes desde experiencia previa relevante. Sugerir funcionalidades o trabajar en ellas es contribución, no stewardship.
43+
3. Participar en los lanzamientos (releases) del software p5.js **apoyando** la corrección de bugs y la finalización de funcionalidades. Por ejemplo, esto significa guiar a otros contribuidores y revisar sus PRs. Corregir bugs es contribución, no stewardship.
44+
45+
El resto de estas directrices proporcionan algunos consejos y trucos que te ayudarán a contribuir efectivamente a p5.js y a guiar las contribuciones de otros. La mayoría de lo escrito aquí existe como pauta a menos que se indique lo contrario. Puedes adaptar estas prácticas para que se ajusten a tu proceso de trabajo.
46+
47+
¡Todos están invitados a ayudar a cuidar la comunidad cuando puedan! Nos alegra ver contribuidores que dan la bienvenida a nuevos contribuidores, revisan el código de otros y proporcionan retroalimentación sobre el diseño de la API. También existen algunos roles concretos:
48+
49+
- Los **contribuidores (contributors)** pueden crear issues, PRs, comentarios y revisiones de código.
50+
- Los **mantenedores (maintainers)** también pueden mergear PRs y administrar otras partes del código del proyecto (codebase).
51+
52+
Los stewards también pueden ser contribuidores: pueden crear issues y PRs como contribuidores, mientras también asumen la responsabilidad, cuando están cuidando un área en particular, de comentar en issues y hacer revisiones de código, especialmente cuando otros contribuidores los etiquetan para ayudar con la discusión y revisión.
53+
54+
Como contribuidor, puedes consultar los stewards actuales en el archivo README del repositorio de p5.js y etiquetar a los stewards relevantes, pero ten en cuenta nuestras directrices para contribuidores, que enfatizan la paciencia y la consideración de que la mayor parte del trabajo técnico en un proyecto de código abierto es voluntario.
55+
56+
Como steward, esperamos que participes regularmente en revisiones de código en issues o PRs que tú no creaste, si están en tu área y si puedes proporcionar orientación útil.
57+
58+
### Áreas
59+
60+
Existen diferentes áreas de trabajo de las cuales los stewards pueden ser responsables. Estas áreas coinciden con las etiquetas (labels) de GitHub en la mayoría de los casos, con un par de excepciones. A continuación se presenta la lista de áreas:
61+
62+
- **Accesibilidad**: Esta área se refiere específicamente a la accesibilidad digital y web, incluyendo, por ejemplo, el soporte para lectores de pantalla mediante API como `describe(..)`, así como el soporte de accesibilidad en el sitio web de referencia
63+
- **Núcleo (Core)**: Se refiere a la API central de p5.js, incluyendo renderizado y entorno
64+
- **DevOps**: Se refiere al proceso de compilación (build process), pruebas unitarias (unit testing) y otros aspectos de la experiencia de desarrollo
65+
- **Documentación**: Incluye tanto la referencia en el código base central que se expone en el sitio web, los documentos para contribuidores y otro contenido del sitio web
66+
- **i18n (Internacionalización / Traducción)**: Incluye la revisión de traducciones, particularmente para `es`, `hi`, `ko`, `zh`
67+
- **Gráficos**: Contiene subáreas de WebGL y [p5.strands](https://beta.p5js.org/tutorials/intro-to-p5-strands/)
68+
- **Color**: Incluye Color, ColorMode, mejoras de accesibilidad relacionadas con el uso del color
69+
- **Tipografía**: Se refiere a todos los temas sobre el manejo de texto y fuentes
70+
- **Matemáticas**: Incluye tanto la Math API externa como mejoras internas de rendimiento
71+
- **Formas (Shapes)**: Incluye el trabajo con formas personalizadas en las versiones 1.11.x y 2.x de p5.js
72+
- **Mantenedores**: Este grupo puede mergear PRs
73+
- **p5.sound.js**: La [nueva biblioteca p5.sound.js](https://github.com/processing/p5.sound.js)
74+
- **p5.js-website**: Aspectos no relacionados con el contenido del [sitio web de referencia](https://p5js.org/), por ejemplo, su estructura, automatizaciones, mejoras técnicas, etc.
75+
76+
Estas áreas de enfoque pueden cambiar con el tiempo dependiendo de las necesidades del proyecto, así que si estás pasando por el proceso de solicitar ser steward, ¡eres bienvenido a proponer nuevas áreas!
77+
78+
### Convertirse en Steward
79+
80+
Hay dos formas de convertirse en steward:
81+
82+
1. **Nominación** por parte de mantenedores u otros stewards, como en conversaciones en Discord, Discourse o GitHub.
83+
2. **Solicitud** creando un PR para actualizar `stewards.yml` con tu usuario de GitHub @ y las áreas propuestas. Ten en cuenta que cada área debe tener de 1 a 3 stewards. ¡Siempre estamos buscando **stewards de traducción**! Una vez que hagas tu PR de solicitud, otros mantenedores o stewards pueden pedir material de apoyo adicional, como hacer un PR relacionado con las áreas en las que estás interesado o participar en alguna discusión relacionada.
84+
85+
Para permanecer como steward, debes contribuir como steward en al menos 1 de los 2 lanzamientos menores más recientes (por ejemplo, 2.1.0 o 1.11.0, cuando cambia el número del medio). Estos no son tan frecuentes como los parches (patches) (por ejemplo, 2.0.3 a 2.0.4, cuando cambia el número más a la derecha), y en la práctica esto significa que se espera que los stewards estén activos cada 4-6 meses aproximadamente, apoyando a otros contribuidores mediante discusión o revisión de código, no necesariamente escribiendo código. Para renunciar al rol de steward, puedes hacer un PR para eliminarte de `stewards.yml`. ¡Siempre eres bienvenido a tomar una pausa y volver a solicitar en el futuro!
86+
87+
### Comenzando como Steward
3188

89+
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.md)) de p5.js como steward.
90+
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.
91+
3. Únete al [Discord de p5.js](https://discord.com/invite/SHQ8dH25r9). ¡En el canal `#contribute-to-p5` cualquier pregunta o propuesta de mejora sobre este proceso es bienvenida!
3292

3393
## _Issues_
3494

0 commit comments

Comments
 (0)