From 7915022ac0c7c442f2afbc0cef128330b3b61030 Mon Sep 17 00:00:00 2001 From: Victor Morales Date: Tue, 3 May 2022 16:58:45 -0700 Subject: [PATCH] feat: add content es/contributor-ladder/_index.md (#830) * Translate Contributor Ladder to spanish * Fix CI path for Spanish spellchecker * [es] Update links to point localized pages Co-authored-by: Jihoon Seo --- .github/workflows/es-spellcheck.yml | 2 +- content/es/.spellcheck.yml | 2 +- content/es/.wordlist.txt | 76 ++++++++++++++++++- content/es/contribute/_index.md | 8 +- content/es/contributor-ladder/_index.md | 98 +++++++++++++++++++++++++ content/es/style-guide/_index.md | 18 ++--- 6 files changed, 187 insertions(+), 17 deletions(-) create mode 100644 content/es/contributor-ladder/_index.md diff --git a/.github/workflows/es-spellcheck.yml b/.github/workflows/es-spellcheck.yml index a4a2d05289..a37d231b26 100644 --- a/.github/workflows/es-spellcheck.yml +++ b/.github/workflows/es-spellcheck.yml @@ -13,7 +13,7 @@ name: Spellcheck CI on: pull_request: paths: - - 'content/es/*.md' + - 'content/es/**/*.md' branches: - dev-es workflow_dispatch: diff --git a/content/es/.spellcheck.yml b/content/es/.spellcheck.yml index b01d20bf30..b1d2bea951 100644 --- a/content/es/.spellcheck.yml +++ b/content/es/.spellcheck.yml @@ -11,7 +11,7 @@ matrix: - name: Spanish content sources: - - 'content/es/*.md' + - 'content/es/**/*.md' default_encoding: utf-8 aspell: lang: es diff --git a/content/es/.wordlist.txt b/content/es/.wordlist.txt index 0e1ba3d622..07a7b6b4b7 100644 --- a/content/es/.wordlist.txt +++ b/content/es/.wordlist.txt @@ -1,3 +1,5 @@ +add +an Aniszczyk Anyul API @@ -10,10 +12,13 @@ AWS Azure backend bare +blob blue +branch Business BVS BY +calendar Carol category Catherine @@ -24,55 +29,122 @@ Chris CI Cloud clúster -CNCF +cncf +code +com +commit Committee +community Completed +concept +conduct contenerización +content +create +creating Daniel declarativamente DevOps DigitalOcean +directly +ej Emiliano +entregables +existing extensibilidad Feedback +first Foster +foundation frontend Garcia gateway GCP -GitHub +github glossary +good +Google +help +hide +https IaC +iamnoah interface +io issue +issues Jason Jhan Jhonnatan +Jihoon +jmo +join Jones Katelin Kubernetes +Language laptop localizations +main +markdown +md +menu +mesh +microservicios Mike mitigarse Morgan Native +needed +new +Not +of +on Paganini +pr profesionistas +properties +propose +PRs pull Rael Ramer request +requests Rivas scripts Seokho +service Slack +Spanish +Started status sub Subcommittee +submit +submitting +subrúbricas +technology +TEMPLATE +term +terms +the title +toc +triaging +true +update +URL Value Vazquez Victor virtualización +vs +weight +wifi +Word +work +www YAML +you +your diff --git a/content/es/contribute/_index.md b/content/es/contribute/_index.md index e0a4d169fd..d0beec0397 100644 --- a/content/es/contribute/_index.md +++ b/content/es/contribute/_index.md @@ -41,7 +41,7 @@ Una vez que te lo asignen, puedes empezar a trabajar en él. Para conocer los pr Puede proponer un nuevo término para que otros trabajen en él o crear una nueva definición usted mismo. De cualquier forma, comenzará creando un issue (tenga en cuenta que necesitará una cuenta de GitHub para hacerlo). -A continuación se muestra una guía paso a paso para aquellos que aún no están familiarizados con GitHub. **Si eres un profesional de GitHub**, *da* un vistazo rápido para asegurarte de que usas nuestras plantillas de issues, las convenciones de nomenclatura, solicita un PR en Slack (de lo contrario, podemos perderlo) y dónde encontrar la plantilla del archivo. Y asegúrese de leer la [Guía de estilo](/style-guide/) antes de comenzar. ¡Gracias! +A continuación se muestra una guía paso a paso para aquellos que aún no están familiarizados con GitHub. **Si eres un profesional de GitHub**, *da* un vistazo rápido para asegurarte de que usas nuestras plantillas de issues, las convenciones de nomenclatura, solicita un PR en Slack (de lo contrario, podemos perderlo) y dónde encontrar la plantilla del archivo. Y asegúrese de leer la [Guía de estilo](/es/style-guide/) antes de comenzar. ¡Gracias! ### Creando un issue {#creating-an-issue} @@ -65,9 +65,9 @@ Tenga en cuenta que solo puede reclamar un término a la vez. Si desea trabajar ### Envío de un nuevo término (creando un PR) {#submitting-a-new-term-creating-a-pr} -Antes de comenzar, lea la [Guía de estilo](/style-guide/) — le ayudará a minimizar el ir de un lado a otro. Como se indica en la guía de estilo, recomendamos encarecidamente el comenzar con un documento de Google o Word. +Antes de comenzar, lea la [Guía de estilo](/es/style-guide/) — le ayudará a minimizar el ir de un lado a otro. Como se indica en la guía de estilo, recomendamos encarecidamente el comenzar con un documento de Google o Word. -Una vez que el término esté listo para ser enviado, vaya a la carpeta de content (en la seccion de Code)… +Una vez que el término esté listo para ser enviado, vaya a la carpeta de content (en la sección de Code)… ![contenido](/images/how-to/howto-05.png) @@ -83,7 +83,7 @@ Copie el contenido… ![copiar contenido](/images/how-to/howto-08.png) -…y vaya atras de la carpeta "es". Presione "add file" y seleccione "create new file." +…y vaya atrás de la carpeta "es". Presione "add file" y seleccione "create new file." ![crear un archivo nuevo](/images/how-to/howto-09.png) diff --git a/content/es/contributor-ladder/_index.md b/content/es/contributor-ladder/_index.md new file mode 100644 index 0000000000..55f1996383 --- /dev/null +++ b/content/es/contributor-ladder/_index.md @@ -0,0 +1,98 @@ +--- +title: Carrera de Contribuidor +toc_hide: true +menu: + main: + weight: 10 +--- + +¡Hola! 👋 Gracias por su interés en contribuir al proyecto de Glosario Cloud Native de la CNCF. Ya sea que contribuya con nuevos términos, ayude a localizar el Glosario en su idioma nativo o quiera ayudar a otros a comenzar, hay muchas maneras de convertirse en un miembro activo de esta comunidad. Este documento describe los diferentes roles de los contribuidores dentro del proyecto y las responsabilidades y privilegios que los acompañan. + +## 1. Contribuidores + +El Glosario es para todos. Cualquiera puede convertirse en contribuidor del Glosario simplemente contribuyendo al proyecto. Se espera que todos los contribuidores sigan el [Código de conducta de CNCF](https://github.com/cncf/foundation/blob/main/code-of-conduct.md). + +Hay una variedad de maneras en las que puede contribuir al proyecto, que incluyen: + +- **Contribuidores de contenido**: todos los que mejoran los términos existentes o contribuyen con nuevos, +- **Contribuidores de localización**: aquellos que ayudan a traducir el glosario a otro idioma, +- **Ayudantes**: cualquiera que ayude a otros en GitHub, Slack o donde sea que los miembros de la comunidad necesiten apoyo, +- **Embajadores**: cualquiera que ayude a correr la voz, educar a la comunidad sobre cómo contribuir y por qué deberían hacerlo. + +Los contribuidores pueden tener varios roles o centrarse en un solo área. **Todas estas contribuciones son igualmente importantes** y ayudan a fomentar una comunidad próspera. Consulte [Cómo contribuir](/es/contribute/) y la [Guía de estilo](/es/style-guide/) para conocer las contribuciones de contenido y localización. + +## 2. Aprobadores + +Los aprobadores proporcionan comentarios sobre los PR y los aprueban. Cualquier contribuidor activo puede convertirse en aprobador (consulte "Convertirse en aprobador"). El Glosario diferencia entre dos tipos de aprobadores: (1) aprobadores para el Glosario en inglés y (2) aprobadores para equipos de localización. + +Se espera que los aprobadores del glosario: + +- Revisen la precisión técnica de los PRs, +- Asignen problemas a los contribuidores y los etiqueten apropiadamente, +- Proporcionen comentarios a los contribuidores y los guíen cuando sea necesario, +- Corrijan y editen las propuestas. + +Si un aprobador ya no está interesado o no puede realizar las tareas anteriores, debe informar a los mantenedores y renunciar. + +### Aprobadores del Glosario en Inglés + +Hay tres tipos de aprobadores: + +1) Aprobadores con una formación técnica sólida, +2) Aprobadores con habilidades sólidas de escritura, +3) Aprobadores que sean competentes en ambos. + +**Aprobadores técnicos**: las personas con una formación técnica sólida pueden ser aprobadores sin tener habilidades sólidas de escritura en el idioma Inglés. Sin embargo, si autorizan la PR por mérito técnico, deben asegurarse de que sea revisada por un aprobador (editor). + +**Editores**: los editores revisan los términos y se aseguran de que se expliquen en un lenguaje sencillo de acuerdo con la Guía de estilo. Si un término está muy editado, el editor debe solicitar a un aprobador técnico que lo revise nuevamente para asegurarse de que el significado no haya sido alterado. + +### Aprobadores de Localización + +El Glosario también tiene aprobadores de localización. Estos son los aprobadores de uno de los equipos de localización (equipos que traducen el glosario). A los aprobadores de localización solo se les permite realizar tareas de aprobación para su propio equipo y tienen la capacidad de fusionar los PRs con su rama de desarrollo dedicada. Cualquier aprobador de localización también puede convertirse en aprobador del glosario en inglés sí cumple con los requisitos. + +### Convertirse en Aprobador + +Los candidatos para un rol de aprobador deben contar un historial comprobado de envío de PRs de alta calidad y ayudar a otros a obtener sus PRs en un estado óptimo para publicar. Si su zona horaria lo permite, también deben asistir regularmente a las [reuniones del Grupo de Trabajo del Glosario](https://www.cncf.io/calendar/). + +Para convertirse en un aprobador, comience expresando interés a los mantenedores existentes. Los mantenedores existentes le pedirán que demuestre las calificaciones anteriores contribuyendo con PRs, haciendo revisiones y realizando otras tareas similares bajo su guía. Después de un tiempo de trabajar juntos, los mantenedores decidirán si le otorgan el estado de aprobador. Esta decisión se basará en su nivel de competencia demostrado y su capacidad de respuesta. + +## 3. Mantenedores + +Los mantenedores son aprobadores que también pueden fusionar PRs. Cualquiera puede convertirse en un mantenedor del Glosario (ver "Convertirse en un mantenedor"). Hay ciertas expectativas para los mantenedores, que incluyen: + +- Ser un aprobador activo y receptivo (ver arriba), +- Ayudar a mantener el repositorio, incluida la configuración del sitio, permisos, la plantilla de issues, el flujo de trabajo de GitHub, entre otros. +- Supervisar los canales de Slack del glosario y ayudar siempre que sea posible, +- Asistir regularmente a las [reuniones del Grupo de trabajo del Glosario](https://www.cncf.io/calendar/) (si la zona horaria lo permite) + +Si un mantenedor ya no está interesado o no puede realizar las funciones enumeradas anteriormente, debe pasar al estado de emérito. + +### Convertirse en Mantenedor + +Los mantenedores deben tener un historial comprobado de ser aprobadores exitosos y enviar PRs de alta calidad. Si su zona horaria lo permite, también deben asistir regularmente a las reuniones del Grupo de Trabajo del Glosario. + +Para convertirse en mantenedor, comience expresando interés a los mantenedores existentes. Los mantenedores existentes le pedirán que demuestre las calificaciones anteriores contribuyendo con PRs, haciendo revisiones y realizando otras tareas similares bajo su guía. Después de un tiempo de trabajar juntos, los mantenedores decidirán si conceden el estatus de mantenedor. Esta decisión se basará en el nivel demostrado de competencia y capacidad de respuesta. + +## 4. Administradores de Comunidad + +Los administradores de comunidad ayudan a fomentar una comunidad acogedora y atractiva. Cualquier miembro de la comunidad puede convertirse en administrador de comunidad. Se espera que: + +- De la bienvenida a nuevos miembros y se asegure de que obtengan la información que necesitan, +- Ayude a responder preguntas de la comunidad o identifique a alguien que pueda ayudar, +- Modere conversaciones en Slack. + +### Conviértase en Administrador de Comunidad + +Cualquiera puede convertirse en administrador de comunidad del Glosario. Los administradores de comunidad deben tener una comprensión sólida del proceso de contribución y localización y disfrutar de la interacción y ayuda a otros. Para convertirse en administrador de comunidad, comience expresando interés a los mantenedores existentes. Después de un período de prueba/incorporación, los mantenedores decidirán si le otorgan el estado de administrador de comunidad en función de su desempeño. + +## Eliminación involuntaria + +La baja involuntaria de un contribuidor ocurre cuando no se cumplen las responsabilidades y requisitos. Esto puede incluir patrones repetidos de inactividad, períodos prolongados de inactividad y/o una violación del código de conducta. Este proceso es importante porque protege a la comunidad y sus entregables al mismo tiempo que abre oportunidades para que intervengan nuevos contribuidores. + +## Proceso de renuncia/emérito + +Siempre y cuando los niveles de compromiso de los contribuidores cambien, los contribuidores pueden considerar renunciar (bajar en la carrera de contribuidores) vs. pasar al estado de emérito (alejarse completamente del proyecto). + +## Retroceder a un rol + +Si alguien está disponible para regresar a un rol de contribuidor anterior, el líder del proyecto puede arreglar y considerar esto. diff --git a/content/es/style-guide/_index.md b/content/es/style-guide/_index.md index 0d5653aded..1470412e19 100644 --- a/content/es/style-guide/_index.md +++ b/content/es/style-guide/_index.md @@ -1,14 +1,14 @@ --- -title: Guia de estilos +title: Guía de estilos toc_hide: true menu: main: weight: 10 --- -Esta guia de estilos te ayudará a entender la audiencia del Glosario, la estructura de las definiciones, el nivel de detalle requerido, y como mantener un estilo consistente. +Esta guía de estilos te ayudará a entender la audiencia del Glosario, la estructura de las definiciones, el nivel de detalle requerido, y como mantener un estilo consistente. -El Glosario Cloud Native sigue las [guias de estilo por defecto](https://github.com/cncf/foundation/blob/master/style-guide.md) del repositorio de CNCF. Adicionalmente, sigue las siguientes reglas: +El Glosario Cloud Native sigue las [guías de estilo por defecto](https://github.com/cncf/foundation/blob/master/style-guide.md) del repositorio de CNCF. Adicionalmente, sigue las siguientes reglas: 1. Utilice un lenguaje sencillo y accesible, evitando la jerga técnica y palabras de moda. 2. [Evite el lenguaje coloquial](https://en.wikipedia.org/wiki/Colloquialism) @@ -65,7 +65,7 @@ La etiqueta **status** vendrá después de la etiqueta del título. La etiqueta Los valores válidos son: - Completed (Completado) -- Feedback Appreciated (Retroalimentacion solicitada) +- Feedback Appreciated (Retroalimentación solicitada) - Not Started (Sin iniciar) Siempre puede abrir un issue a una definición completa. Mientras una definición está cambiando, su estado cambiará a *Feedback Appreciated*. @@ -99,7 +99,7 @@ category: Concepto Las definiciones de las categorías **technology** y **concept** contienen tres subrúbricas: - **Qué es**: proporciona una descripción breve y clara de lo que estamos hablando. -- **Problema que aborda**: enfocate en el problema, no en la solución (que viene en la siguiente sección). De hecho, evite mencionar el término que se esta definiendo. El problema se centra en *qué* nos llevó a necesitar esto. +- **Problema que aborda**: enfócate en el problema, no en la solución (que viene en la siguiente sección). De hecho, evite mencionar el término que se esta definiendo. El problema se centra en *qué* nos llevó a necesitar esto. - **Cómo ayuda**: ahora, vuelve al término. ¿Cómo aborda el problema descrito anteriormente? Tenga en cuenta que la etiqueta **properties** no requiere secciones separadas. Una definición será suficiente. @@ -112,18 +112,18 @@ Cuando corresponda, use **ejemplos del mundo real** que ayuden a los lectores (e Cuando se use en su definición, siempre **enlace a los términos existentes del glosario** (solo la primera mención debe tener un hipervínculo). -**Ejemplo**: eche un vistazo a la sección "Qué es" de la [definición de service mesh](/service_mesh/). Se vincula con las definiciones de microservicios, servicio, confiabilidad y observabilidad. Además, utiliza un ejemplo del mundo real que compara los desafíos de la red en un entorno de microservicios (algo con lo que las personas no técnicas no pueden relacionarse) con los problemas de wifi (algo que cualquiera que use una computadora portátil puede entender). Siempre que sea posible, trate de hacer esa conexión. +**Ejemplo**: eche un vistazo a la sección "Qué es" de la [definición de service mesh](/service_mesh/). Se vincula con las definiciones de microservicios, servicio, fiabilidad y observabilidad. Además, utiliza un ejemplo del mundo real que compara los desafíos de la red en un entorno de microservicios (algo con lo que las personas no técnicas no pueden relacionarse) con los problemas de wifi (algo que cualquiera que use una computadora portátil puede entender). Siempre que sea posible, trate de hacer esa conexión. #### Comience con un documento de Google o Word -Recomendamos comenzar con un documento de Google o Word, dejalo pasar durante unos días y volver a visitarlo. Esto te permitirá captar frases o expresiones que podrían redactarse de una forma más sencilla y accesible. Además, asegúrese de ejecutar un corrector ortográfico antes de enviar un PR. +Recomendamos comenzar con un documento de Google o Word, déjalo pasar durante unos días y volver a visitarlo. Esto te permitirá captar frases o expresiones que podrían redactarse de una forma más sencilla y accesible. Además, asegúrese de ejecutar un corrector ortográfico antes de enviar un PR. -Para asegurarse de que nadie más envíe un PR mientras trabaja en un término, asegúrese de reclamar un issue (o crear uno) y que se le asigne. Más sobre eso en el documento [Cómo contribuir](/contribute/). +Para asegurarse de que nadie más envíe un PR mientras trabaja en un término, asegúrese de reclamar un issue (o crear uno) y que se le asigne. Más sobre eso en el documento [Cómo contribuir](/es/contribute/). Antes de comenzar, lea algunos de los términos publicados del Glosario para tener una idea del nivel de detalle y dificultad y cuándo los ejemplos son apropiados. ## El proceso de revisión: qué esperar -Tenga en cuenta que actualmente solo hay tres mantenedores haciendo esto en su tiempo libre. Ocasionalmente, podremos revisar los términos rápidamente; en otras ocasiones, puede llevar algo de tiempo. Agradecemos su paciencia. Si tiene alguna pregunta, comuníquese con nosotros en el canal #glossary de Slack (para saber dónde y cómo encontrarlo, consulte nuestro documento de [Cómo contribuir](/contribute/)). +Tenga en cuenta que actualmente solo hay tres mantenedores haciendo esto en su tiempo libre. Ocasionalmente, podremos revisar los términos rápidamente; en otras ocasiones, puede llevar algo de tiempo. Agradecemos su paciencia. Si tiene alguna pregunta, comuníquese con nosotros en el canal #glossary de Slack (para saber dónde y cómo encontrarlo, consulte nuestro documento de [Cómo contribuir](/es/contribute/)). Nuestro objetivo es que el Glosario sea el mejor recurso posible. Una vez que envíe un PR, podemos solicitar una o más revisiones. No se sienta frustrado, ese es el caso de muchos relaciones públicas. Esas idas y venidas y nuestra colaboración asegurarán que su contribución se convierta en una definición verdaderamente útil leída y referida por lectores de todo el mundo.