Como contribuir

El contenido del Glosario Cloud Native se almacena en este repositorio de GitHub donde encontrará una lista de issues, PRs y discusiones sobre el glosario.

Existen tres formas en las que puedes contribuir:

1. Trabajar en un issue existente
2. Proponer nuevos términos
3. Actualizar los existentes
4. Ayudar a traducir el glosario

¡Únete a la comunidad del glosario!

Considere unirse a nuestras reuniones mensuales del Grupo de trabajo del glosario si es que desea contribuir con regularidad. Puede encontrar los detalles de la reunión en el [calendario de la CNCF]((https://www.cncf.io/calendar/). También puede conectarse con los mantenedores y otros colaboradores en nuestro canal #glossary en el calendario CNCF. ¡Nos encantaría conocerte!

Trabajar en un issue existente

Vaya a los issues del repositorio de Glosario en GitHub. Allí verá una lista de todos los issues. Puede filtrar por etiqueta (por ejemplo, idioma español, ‘help needed’, ‘good first issue’). Tenga en cuenta que necesitará una cuenta de GitHub para hacer esto.

Asegúrese de que el término que le interesa no esté ya asignado a alguien mas. Aquí puede ver que los primeros tres términos están disponibles mientras que el próximo término ya ha sido asignado.

Una vez que haya encontrado un término en el que desea trabajar, dígalo en el issue. Haga clic en él y agregue un comentario.

Además, también únase al canal #glossary en el CNCF Slack e informe a los mantenedores que ha creado un issue para un nuevo término (idealmente , etiqueta a @Catherine Paganini, @jmo, @Seokho Son, @Jihoon Seo y/o @iamnoah para asegurarse de que no se lo pierdan). Tenga en cuenta que solo puede reclamar un término a la vez. Si desea trabajar en varios términos, termine uno antes de reclamar el siguiente.

Una vez que te lo asignen, puedes empezar a trabajar en él. Para conocer los próximos pasos, consulte la sección Enviar un nuevo término (crear un PR).

Proponer nuevos términos

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 debe cumplir los términos de la [definición nativa para la nube de CNCF] (https://github.com/cncf/toc/blob/main/DEFINITION.md). Las únicas excepciones son los términos básicos necesarios para comprender los conceptos nativos de la nube.

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 antes de comenzar. ¡Gracias!

Creando un issue

Vaya a los issues del repositorio del Glosario en GitHub y haga clic en “New issue”.

Verá una variedad de plantillas. Para proponer un nuevo término en Español, seleccione “Request to update existing term (Non-English)”.

Agregue la palabra que está sugiriendo, responda las dos preguntas a continuación, marque las casillas de verificación y presione “Submit new issue”. Si solo está proponiendo un nuevo término, ¡ya está listo! Para trabajar en ello, siga los siguientes pasos.

Evaluación tu issue

A continuación, los mantenedores evaluarán el issue. Eso significa que evaluarán si el término debe formar parte del Glosario (tenga en cuenta que no se admitirán todos los términos. Los términos deben ser términos nativos de la nube establecidos y ampliamente utilizados).

Infórmeles a los mantenedores que ha enviado un término en Slack, ya que de lo contrario podrían perderlo. Lo ideal es etiquetar a @Catherine Paganini, @jmo, @Seokho Son, @Jihoon Seo y/o @iamnoah. Si el término es aprobado y quieres trabajar en él, ellos te lo asignarán.

Tenga en cuenta que solo puede reclamar un término a la vez. Si desea trabajar en varios términos, termine uno antes de reclamar el siguiente.

Envío de un nuevo término (creando un PR)

Antes de comenzar, lea la Guía de estilo — 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 sección de code)…

…luego “es” …

…y seleccione _TEMPLATE.md

Copie el contenido…

…y vaya atrás de la carpeta “es”. Presione “Add file” y seleccione “Create new file.”

Agregue el nombre del término en la URL (sin mayúsculas ni espacios ni paréntesis y usando guiones para separar palabras) y .md al final (nota: si su vista previa no funciona, probablemente olvidó agregar .md al final). A continuación pegue el contenido de la plantilla. Copie y pegue su definición en el archivo. Para facilitar las revisiones, use semántica de saltos de línea (por ejemplo, una línea por oración). Tenga en cuenta que GitHub usa Markdown para formatear el texto (p. ej., hipervínculo, negrita, cursiva). Consulte esta hoja de referencia para markdown. Para verificar que usó Markdown según lo pensado, vaya a “Preview”.

Desplácese hacia abajo y asigne un nombre al nuevo archivo de confirmación cuando esté listo para enviarlo. Ahora está a punto de asignar el término a su propio branch. Para enviar el PR se requiere un paso adicional. Presiona “Commit new file” y…

…ahora you estas creando un PR:

Ahora debería ver su PR en “Pull requests.”

Actualizando un término existente

Para actualizar un término existente, puede sugerir un cambio a través de un issue o continuar y actualizar el término directamente enviando un pull request (PR).

Solicitar un cambio a través de un issue

Si desea marcar un problema con un término pero no sabe cómo hacerlo o desea solucionarlo usted mismo, haga clic en “Reportar un issue”.

Esto abrirá directamente un issue. Explique qué cambio es necesario y por qué. Presiona enviar, y eso es todo.

Actualizar un término directamente

Para cambiar un término directamente, vaya a “Editar esta página”.

Esto abrirá la página de término en GitHub. Realice sus cambios y envíe un PR. Consulte “Envío de un nuevo término” más arriba para obtener una descripción mas detallada (salte a la sección que habla acerca de markdown).

Ayuda a traducir el glosario

Para ayudar a traducir el glosario a su idioma, únase al canal #glossary-localizations en CNCF Slack y háganoslo saber. Puede unirse a un equipo existente o crear uno nuevo (para ver lo que se necesita, consulte la Guía de localización). Únase también a nuestras juntas mensuales del grupo de trabajo. Puede encontrar mas detalles en el calendario de la CNCF. ¡Esperamos verte allí!