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. También puede conectarse con los mantenedores y otros colaboradores en nuestro canal #glossary en el calendario CNCF. ¡Nos encantaría conocerlo!

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.

Issue y etiquetas

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.

asignando un término

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.

Reclamando un issue

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

Creando un issue

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

issues

Verá una variedad de plantillas. Para proponer un nuevo término en Español, seleccione “Spanish Language Glossary Request”.

plantilla

Agregue la palabra que está sugiriendo 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)…

contenido

…luego “es” …

carpeta de idioma

…y seleccione _TEMPLATE.md

plantilla

Copie el contenido…

copiar contenido

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

crear un archivo nuevo

Agregue el nombre del término en la URL (sin mayúsculas ni espacios) 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. 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 “vista previa”.

completar un término

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…

commit nuevo archivo

…ahora you estas creando un PR:

crear un pr

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

prs

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”.

reportar issue

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

entregar issue

Actualizar un término directamente

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

edit this page

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í!


Modificado(a) por última vez August 16, 2022: Some fixes (#1181) (e8cb8ee)