From 8d34c9a42d2d68c2987f6c6b667d072d7a502355 Mon Sep 17 00:00:00 2001 From: Diana Todea Date: Mon, 27 Jan 2025 16:42:38 +0100 Subject: [PATCH 1/4] feat: [es] Create docs/contributing/asuntos.md Signed-off-by: Diana Todea --- content/es/docs/contributing/_index.md | 2 +- content/es/docs/contributing/asuntos.md | 107 ++++++++++++++++++++++++ 2 files changed, 108 insertions(+), 1 deletion(-) create mode 100644 content/es/docs/contributing/asuntos.md diff --git a/content/es/docs/contributing/_index.md b/content/es/docs/contributing/_index.md index c9c32dc312b1..4c2bf84325b8 100644 --- a/content/es/docs/contributing/_index.md +++ b/content/es/docs/contributing/_index.md @@ -2,7 +2,7 @@ title: Contribuir description: Aprende cómo contribuir a la documentación de OpenTelemetry. weight: 980 -default_lang_commit: 30783526402b69a3ac44eeb0f6cf066732f0bdca +default_lang_commit: 8256a7512f0f5e677963e082d257edc443940565 --- Quienes colaboran para documentar OpenTelemetry: diff --git a/content/es/docs/contributing/asuntos.md b/content/es/docs/contributing/asuntos.md new file mode 100644 index 000000000000..ad9699361b09 --- /dev/null +++ b/content/es/docs/contributing/asuntos.md @@ -0,0 +1,107 @@ +--- +title: Asuntos +description: + Cómo solucionar un problema existente o informar un error, un riesgo de + seguridad o una posible mejora. +weight: 10 +_issues: https://github.com/open-telemetry/opentelemetry.io/issues +_issue: https://github.com/open-telemetry/opentelemetry.io/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A +cSpell:ignore: prepopulated +--- + +## Solucionando un asunto existente + +Una de las mejores maneras de ayudar a mejorar los documentos de OTel es +solucionar un asunto existente. + +1. Navegar por la lista de asuntos [issues]({{% param _issues %}}). +2. Seleccione un asunto en el que le gustaría trabajar, idealmente uno que se + pueda solucionar en poco tiempo. + + + + {{% alert title="Contribuyendo por la primera vez? " %}} + + Seleccione un asunto con las siguientes etiquetas: + + - [Buen primer asunto] + - [Se busca ayuda] + + + > **NOTA**: no **_ asignamos asuntos** a aquellos que aún no hayan realizado contribuciones a la organización [OpenTelemetry + > organization][org], aunque sean parte de un proceso de tutoria o incorporación. + {.mt-3} + + + [buen primer asunto]: {{% param _issue %}}%22good+first+issue%22 + [se busca ayuda]: {{% param _issue %}}%3A%22help+wanted%22 + [org]: https://github.com/open-telemetry + + {{% /alert %}} + +3. Lea los comentarios del problema, si los hay. +4. Pregúntele a los encargados del mantenimiento si este asunto sigue siendo + relevante y haga cualquier pregunta que necesite para aclarar el problema + publicando comentarios sobre el problema. +5. Comparte tu intención de trabajar en el tema agregando un comentario a este + efecto. +6. Trabaja para solucionar el problema. Informa a los encargados del + mantenimiento si tiene algún problema. +7. Cuando este listo, + [envia tu trabajo enviando un pull request](../pull-requests) (PR). + +## Reportar un problema + +Si encuentras un error o quieres hacer unas sugerencias para ameliorar el +contenido existente, abre un asunto. + +1. Haz click en el enlace **Crea un asunto para la documentación** de cualquier + documento. Eso te va a redireccionar a una pagina del asunto GitHub + precargado con algunos encabezados. +2. Describa el problema o la sugerencia de mejora. Proporcione tantos detalles + como pueda. +3. Haz click en **Submit new issue**. + +Después de enviar el problema, verifique su problema de vez en cuando o active +las notificaciones de GitHub. Puede que pasen algunos días hasta que los +encargados del mantenimiento y aprobación respondan. Los revisores y otros +miembros de la comunidad pueden hacer preguntas antes de poder tomar medidas +sobre su problema. + +## Sugerir nuevos contenidos o funciones + +Si tienes una idea para un nuevo contenido o una nueva función, pero no estás +seguro de dónde debería ir, aún puedes presentar un asunto. También puedes +informar errores y vulnerabilidades de seguridad. + +1. Ir a [GitHub](https://github.com/open-telemetry/opentelemetry.io/issues/new/) + y selecciona **Nuevo asunto** dentro de la pestaña **Asuntos**. + +1. Seleccione el tipo de problema que mejor se aplica a su solicitud o duda. + +1. Rellene la plantilla. + +1. Envia el asunto. + +### Como presentar buenos asuntos + +Tenga en cuenta lo siguiente al presentar un asunto: + +- Proporcione una descripción clara del problema. Describa específicamente qué + falta, qué está desactualizado, qué está mal o qué necesita mejorarse. +- Explique el impacto específico que tiene el problema en los usuarios. +- Limite el alcance de un problema determinado a una unidad de trabajo + razonable. En el caso de problemas de gran alcance, divídalos en problemas más + pequeños. Por ejemplo, "Reparar los documentos de seguridad" es demasiado + amplio, pero "Agregar detalles al tema 'Restringir el acceso a la red'" es lo + suficientemente específico como para que se pueda llevar a cabo una acción. +- Busque los problemas existentes para ver si hay algo relacionado o similar al + nuevo problema. +- Si el nuevo problema se relaciona con otro problema o solicitud de + incorporación de cambios, haga referencia a él por su URL completa o por el + número del problema o solicitud de incorporación de cambios precedido por el + carácter `#`, por ejemplo `Introducido por #987654`. +- Sigue el + [Código de conducta](https://github.com/open-telemetry/community/blob/main/code-of-conduct.md). + Respete a sus compañeros colaboradores. Por ejemplo, decir "Los documentos son + terribles" no es un comentario útil ni cortés. From b1e409d7c8099765d5b6e8d5df1f5722a3f68861 Mon Sep 17 00:00:00 2001 From: Diana Todea Date: Mon, 27 Jan 2025 18:24:04 +0100 Subject: [PATCH 2/4] feat: [es] Create docs/contributing/issues.md Signed-off-by: Diana Todea --- content/es/docs/contributing/{asuntos.md => issues.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename content/es/docs/contributing/{asuntos.md => issues.md} (100%) diff --git a/content/es/docs/contributing/asuntos.md b/content/es/docs/contributing/issues.md similarity index 100% rename from content/es/docs/contributing/asuntos.md rename to content/es/docs/contributing/issues.md From 1c3f1dd4d007c1eadc0afab4a567510ad60e8f1e Mon Sep 17 00:00:00 2001 From: Diana Todea Date: Wed, 29 Jan 2025 16:39:08 +0100 Subject: [PATCH 3/4] feat: [es] Create docs/contributing/issues.md Signed-off-by: Diana Todea --- content/es/docs/contributing/issues.md | 27 ++++++++++++-------------- 1 file changed, 12 insertions(+), 15 deletions(-) diff --git a/content/es/docs/contributing/issues.md b/content/es/docs/contributing/issues.md index ad9699361b09..d489dc360aac 100644 --- a/content/es/docs/contributing/issues.md +++ b/content/es/docs/contributing/issues.md @@ -11,8 +11,7 @@ cSpell:ignore: prepopulated ## Solucionando un asunto existente -Una de las mejores maneras de ayudar a mejorar los documentos de OTel es -solucionar un asunto existente. +Una de las mejores maneras de contribuir a mejorar la documentación de OpenTelemetry (OTel) es solucionando un problema ya identificado. 1. Navegar por la lista de asuntos [issues]({{% param _issues %}}). 2. Seleccione un asunto en el que le gustaría trabajar, idealmente uno que se @@ -28,7 +27,7 @@ solucionar un asunto existente. - [Se busca ayuda] - > **NOTA**: no **_ asignamos asuntos** a aquellos que aún no hayan realizado contribuciones a la organización [OpenTelemetry + > **NOTA**: **_No_ asignamos asuntos** a aquellos que aún no hayan contribuido a la organización [OpenTelemetry > organization][org], aunque sean parte de un proceso de tutoria o incorporación. {.mt-3} @@ -40,37 +39,35 @@ solucionar un asunto existente. {{% /alert %}} 3. Lea los comentarios del problema, si los hay. -4. Pregúntele a los encargados del mantenimiento si este asunto sigue siendo - relevante y haga cualquier pregunta que necesite para aclarar el problema - publicando comentarios sobre el problema. +4. Pregunta a los mantenedores si el asunto sigue siendo + relevante y aclara cualquier duda publicando un comentario. 5. Comparte tu intención de trabajar en el tema agregando un comentario a este efecto. -6. Trabaja para solucionar el problema. Informa a los encargados del - mantenimiento si tiene algún problema. +6. Trabaja para solucionar el problema y notifica a los mantenedores si surge algún inconveniente. 7. Cuando este listo, [envia tu trabajo enviando un pull request](../pull-requests) (PR). ## Reportar un problema -Si encuentras un error o quieres hacer unas sugerencias para ameliorar el +Si encuentras un error o quieres hacer unas sugerencias para mejorar el contenido existente, abre un asunto. 1. Haz click en el enlace **Crea un asunto para la documentación** de cualquier documento. Eso te va a redireccionar a una pagina del asunto GitHub - precargado con algunos encabezados. + prellenada con algunos encabezados. 2. Describa el problema o la sugerencia de mejora. Proporcione tantos detalles como pueda. 3. Haz click en **Submit new issue**. Después de enviar el problema, verifique su problema de vez en cuando o active las notificaciones de GitHub. Puede que pasen algunos días hasta que los -encargados del mantenimiento y aprobación respondan. Los revisores y otros +mantenedores respondan. Los revisores y otros miembros de la comunidad pueden hacer preguntas antes de poder tomar medidas sobre su problema. ## Sugerir nuevos contenidos o funciones -Si tienes una idea para un nuevo contenido o una nueva función, pero no estás +Si tienes una idea para un nuevo contenido o funcionalidad, pero no estás seguro de dónde debería ir, aún puedes presentar un asunto. También puedes informar errores y vulnerabilidades de seguridad. @@ -91,9 +88,9 @@ Tenga en cuenta lo siguiente al presentar un asunto: falta, qué está desactualizado, qué está mal o qué necesita mejorarse. - Explique el impacto específico que tiene el problema en los usuarios. - Limite el alcance de un problema determinado a una unidad de trabajo - razonable. En el caso de problemas de gran alcance, divídalos en problemas más - pequeños. Por ejemplo, "Reparar los documentos de seguridad" es demasiado - amplio, pero "Agregar detalles al tema 'Restringir el acceso a la red'" es lo + razonable. En el caso de problemas de gran alcance, divídelos en tareas más + pequeñas. Por ejemplo, "Corregir la documentación de seguridad" es demasiado + amplio, pero "Agregar detalles en la sección 'Restringir el acceso a la red'" es lo suficientemente específico como para que se pueda llevar a cabo una acción. - Busque los problemas existentes para ver si hay algo relacionado o similar al nuevo problema. From 7d0d2cd539aa572f12510fab68050eb5d6a16f8f Mon Sep 17 00:00:00 2001 From: Diana Todea Date: Thu, 30 Jan 2025 09:42:24 +0100 Subject: [PATCH 4/4] feat: [es] Create docs/contributing/issues.md Signed-off-by: Diana Todea --- content/es/docs/contributing/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/es/docs/contributing/_index.md b/content/es/docs/contributing/_index.md index 4c2bf84325b8..ec49b50d0750 100644 --- a/content/es/docs/contributing/_index.md +++ b/content/es/docs/contributing/_index.md @@ -2,7 +2,7 @@ title: Contribuir description: Aprende cómo contribuir a la documentación de OpenTelemetry. weight: 980 -default_lang_commit: 8256a7512f0f5e677963e082d257edc443940565 +default_lang_commit: 9a838dc99f57a0e7dd71b04f70e49dfd2df9feb4 --- Quienes colaboran para documentar OpenTelemetry: