From 92d38600b0afa146d350eeb4732dd6fb636f3bb4 Mon Sep 17 00:00:00 2001 From: Ale Mohamad Date: Thu, 14 Sep 2023 13:38:36 +0200 Subject: [PATCH 1/6] Add Spanish translation for contributing.md --- docs/contributing/contributing.es.md | 57 ++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 docs/contributing/contributing.es.md diff --git a/docs/contributing/contributing.es.md b/docs/contributing/contributing.es.md new file mode 100644 index 000000000..91bcfa320 --- /dev/null +++ b/docs/contributing/contributing.es.md @@ -0,0 +1,57 @@ +# Colaborar con Vapor + +Vapor es un proyecto impulsado por la comunidad y las contribuciones de los miembros de la comunidad constituyen una parte importante del desarrollo de Vapor. ¡Esta guía te ayudará a comprender el proceso de colaboración y te ayudará a realizar tus primeros commits en Vapor! + +¡Cualquier aporte que hagas es útil! Incluso cosas pequeñas como corregir errores tipográficos marcan una gran diferencia para las personas que usan Vapor. + +## Código de Conducta + +Vapor ha adoptado el Código de Conducta de Swift, que se puede encontrar en [https://www.swift.org/code-of-conduct/](https://www.swift.org/code-of-conduct/). Se espera que todos los colaboradores sigan este código de conducta. + +## ¿En que trabajar? + +¡Decir en qué trabajar puede ser un gran obstáculo cuando se trata de comenzar con el código abierto! Por lo general, las mejores cosas en las que trabajar son los problemas que encuentres o las funciones que desees. Sin embargo, Vapor tiene algunas cosas útiles que te ayudarán a colaborar. + +### Problemas de Seguridad + +Si descubres un problema de seguridad y deseas informarlo o ayudar a solucionarlo, **no** plantees un issue ni crees un pull request. Contamos con un proceso separado para problemas de seguridad para garantizar que no expongamos vulnerabilidades hasta que haya una solución disponible. Envía un correo electrónico a security@vapor.codes o [consulta aquí](https://github.com/vapor/.github/blob/main/SECURITY.md) para obtener más detalles. + +### Pequeños problemas + +Si encuentras un pequeño problema, error o error tipográfico, no dudes en seguir adelante y crear una pull request para solucionarlo. Si resuelves un problema abierto en cualquiera de los repositorios, puedes vincularlo en la pull request en la barra lateral para que el problema se cierre automáticamente cuando se haga merge la pull request. + +![GitHub Link Issue](../images/github-link-issue.png) + +### Nuevas funcionalidades + +Si deseas proponer cambios más importantes, como nuevas funcionalidades o correcciones de errores que cambian cantidades significativas de código, primero abre un issue o publíquelo en el canal `#development` en Discord. Esto nos permite discutir el cambio contigo, ya que puede haber algún contexto que debamos aplicar o podemos ofrecerte sugerencias. ¡No queremos que pierdas el tiempo si una función no encaja con nuestros planes! + +### Tableros de Vapor + +Si solo quieres contribuir pero no tienes idea de en qué trabajar, ¡eso es fantástico! Vapor tiene un par de tableros que pueden ayudar. Vapor tiene alrededor de 40 repositorios que se desarrollan activamente y revisarlos todos para encontrar algo en lo que trabajar no es práctico, por lo que usamos tableros para organizar dichas tareas. + +El primer tablero es el [tablero de good first issue](https://github.com/orgs/vapor/projects/10). Cualquier problema en la organización GitHub de Vapor que esté etiquetado como `good first issue` se agregará al tablero para que lo encuentres. Estos son temas que creemos que serán buenos para que trabajen las personas relativamente nuevas en Vapor, ya que no requieren mucha experiencia con el código. + +El segundo tablero es el [tablero de help wanted](https://github.com/orgs/vapor/projects/11). Esto genera issues etiquetados como `help wanted`. Estos son problemas que podrían solucionarse, pero el equipo central actualmente tiene otras prioridades. Estos problemas generalmente requieren un poco más de conocimiento si no están marcados con `good first issue`, ¡pero podrían ser proyectos divertidos en los que trabajar! + +### Traducciones + +El último ámbito donde las contribuciones son extremadamente valiosas es la documentación. La documentación tiene traducciones para varios idiomas, pero no todas las páginas están traducidas y hay muchos más idiomas que nos gustaría disponer. Si estás interesado en contribuir con nuevos idiomas o actualizaciones, consulta el [README de los docs](https://github.com/vapor/docs#translating) o comunícate en el canal `#documentation` en Discord. + +## Proceso de Colaboración + +Si nunca has trabajado en un proyecto de código abierto, los pasos para colaborar pueden resultar confusos, pero son bastante simples. + +Primero, haz un fork de Vapor o cualquier repositorio en el que quieras trabajar. Puedes hacer esto en la UI de GitHub y GitHub tiene [algunos documentos excelentes](https://docs.github.com/es/get-started/quickstart/fork-a-repo) sobre cómo hacer esto. + +Luego puede realizar cambios en tu fork con el proceso habitual de commit y push. Una vez que estés listo para enviar tu solución, puedes crear una PR en el repositorio de Vapor. Nuevamente, GitHub tiene [documentos excelentes](https://docs.github.com/es/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork) sobre cómo hacer esto. + +## Enviar una Pull Request + +Al enviar una pull request, hay varias cosas que debes verificar: + +* Todos los tests pasan +* Se agregaron nuevos tests para cualquier comportamiento nuevo o errores corregidos +* Se documentan nuevas APIs públicas. Usamos DocC para documentar nuestra API. + +Vapor utiliza la automatización para reducir la cantidad de trabajo necesario para muchas tareas. Para las pull requests, utilizamos [Vapor Bot](https://github.com/VaporBot) para generar actualizaciones cuando se fusiona una pull request. El cuerpo y el título de la pull request se utilizan para generar las notas de la nueva versión, así que asegúrate de que tengan sentido y cubran lo que esperarías ver en las notas de la nueva versión. Tenemos más detalles sobre las [directrices de colaboración en Vapor](https://github.com/vapor/vapor/blob/main/.github/contributing.md#release-title). From 83cf8281c44d1005df2e12074a7aab111d8dd368 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ale=20Mohamad=20=E2=8C=98?= Date: Sun, 17 Sep 2023 12:25:15 +0200 Subject: [PATCH 2/6] Update contributing.es.md Co-authored-by: Jorge Acosta <104621044+jacostaf10@users.noreply.github.com> --- docs/contributing/contributing.es.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/contributing/contributing.es.md b/docs/contributing/contributing.es.md index 91bcfa320..08f273eff 100644 --- a/docs/contributing/contributing.es.md +++ b/docs/contributing/contributing.es.md @@ -1,6 +1,6 @@ # Colaborar con Vapor -Vapor es un proyecto impulsado por la comunidad y las contribuciones de los miembros de la comunidad constituyen una parte importante del desarrollo de Vapor. ¡Esta guía te ayudará a comprender el proceso de colaboración y te ayudará a realizar tus primeros commits en Vapor! +Vapor es un proyecto impulsado por la comunidad y las contribuciones de los miembros constituyen una parte importante de su desarrollo. Esta guía te ayudará a comprender el proceso de colaboración y a realizar tus primeros commits en Vapor. ¡Cualquier aporte que hagas es útil! Incluso cosas pequeñas como corregir errores tipográficos marcan una gran diferencia para las personas que usan Vapor. From 19126f186be40447808814e945b56d92a129ed77 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ale=20Mohamad=20=E2=8C=98?= Date: Sun, 17 Sep 2023 12:26:15 +0200 Subject: [PATCH 3/6] Update contributing.es.md Co-authored-by: Jorge Acosta <104621044+jacostaf10@users.noreply.github.com> --- docs/contributing/contributing.es.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/contributing/contributing.es.md b/docs/contributing/contributing.es.md index 08f273eff..43fbc6419 100644 --- a/docs/contributing/contributing.es.md +++ b/docs/contributing/contributing.es.md @@ -10,7 +10,7 @@ Vapor ha adoptado el Código de Conducta de Swift, que se puede encontrar en [ht ## ¿En que trabajar? -¡Decir en qué trabajar puede ser un gran obstáculo cuando se trata de comenzar con el código abierto! Por lo general, las mejores cosas en las que trabajar son los problemas que encuentres o las funciones que desees. Sin embargo, Vapor tiene algunas cosas útiles que te ayudarán a colaborar. +Decidir en qué trabajar puede ser un gran obstáculo cuando se trata de comenzar con el código abierto. Por lo general, las mejores cosas en las que trabajar son los problemas que encuentres o las funciones que desees. Sin embargo, Vapor tiene algunas cosas útiles que te ayudarán a colaborar. ### Problemas de Seguridad From a04a6f7a1c844458e6bfe4537b657e7bc05c7d06 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ale=20Mohamad=20=E2=8C=98?= Date: Sun, 17 Sep 2023 12:26:44 +0200 Subject: [PATCH 4/6] Update contributing.es.md Co-authored-by: Jorge Acosta <104621044+jacostaf10@users.noreply.github.com> --- docs/contributing/contributing.es.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/contributing/contributing.es.md b/docs/contributing/contributing.es.md index 43fbc6419..50593dafe 100644 --- a/docs/contributing/contributing.es.md +++ b/docs/contributing/contributing.es.md @@ -18,7 +18,7 @@ Si descubres un problema de seguridad y deseas informarlo o ayudar a solucionarl ### Pequeños problemas -Si encuentras un pequeño problema, error o error tipográfico, no dudes en seguir adelante y crear una pull request para solucionarlo. Si resuelves un problema abierto en cualquiera de los repositorios, puedes vincularlo en la pull request en la barra lateral para que el problema se cierre automáticamente cuando se haga merge la pull request. +Si encuentras un pequeño problema, error o error tipográfico, no dudes en seguir adelante y crear una pull request para solucionarlo. Si soluciona un issue abierto en cualquiera de los repositorios, puedes vincularlo en la pull request en la barra lateral para que se cierre automáticamente cuando se hacer el merge. ![GitHub Link Issue](../images/github-link-issue.png) From b1cbb243c8f36e2351168a5f6157e0c9b4fc024b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ale=20Mohamad=20=E2=8C=98?= Date: Sun, 17 Sep 2023 12:27:09 +0200 Subject: [PATCH 5/6] Update contributing.es.md Co-authored-by: Jorge Acosta <104621044+jacostaf10@users.noreply.github.com> --- docs/contributing/contributing.es.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/contributing/contributing.es.md b/docs/contributing/contributing.es.md index 50593dafe..5ca7175e5 100644 --- a/docs/contributing/contributing.es.md +++ b/docs/contributing/contributing.es.md @@ -24,7 +24,7 @@ Si encuentras un pequeño problema, error o error tipográfico, no dudes en segu ### Nuevas funcionalidades -Si deseas proponer cambios más importantes, como nuevas funcionalidades o correcciones de errores que cambian cantidades significativas de código, primero abre un issue o publíquelo en el canal `#development` en Discord. Esto nos permite discutir el cambio contigo, ya que puede haber algún contexto que debamos aplicar o podemos ofrecerte sugerencias. ¡No queremos que pierdas el tiempo si una función no encaja con nuestros planes! +Si deseas proponer cambios más importantes, como nuevas funcionalidades o correcciones de errores que cambian cantidades significativas de código, primero abre un issue o publícalo en el canal `#development` en Discord. Esto nos permite discutir el cambio contigo, ponerlo en contexto y ofrecerte sugerencias. ¡No queremos que pierdas el tiempo si una función no encaja con nuestros planes! ### Tableros de Vapor From 2440f318175fd7c0930b8bf940dc3e74181c5847 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ale=20Mohamad=20=E2=8C=98?= Date: Sun, 17 Sep 2023 15:55:45 +0200 Subject: [PATCH 6/6] Update contributing.es.md Co-authored-by: Jorge Acosta <104621044+jacostaf10@users.noreply.github.com> --- docs/contributing/contributing.es.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/contributing/contributing.es.md b/docs/contributing/contributing.es.md index 5ca7175e5..c1b5acf6e 100644 --- a/docs/contributing/contributing.es.md +++ b/docs/contributing/contributing.es.md @@ -18,7 +18,7 @@ Si descubres un problema de seguridad y deseas informarlo o ayudar a solucionarl ### Pequeños problemas -Si encuentras un pequeño problema, error o error tipográfico, no dudes en seguir adelante y crear una pull request para solucionarlo. Si soluciona un issue abierto en cualquiera de los repositorios, puedes vincularlo en la pull request en la barra lateral para que se cierre automáticamente cuando se hacer el merge. +Si encuentras un pequeño problema, error o error tipográfico, no dudes en seguir adelante y crear una pull request para solucionarlo. Si soluciona un issue abierto en cualquiera de los repositorios, puedes vincularlo en la pull request en la barra lateral para que se cierre automáticamente cuando se hace el merge. ![GitHub Link Issue](../images/github-link-issue.png)