feat: [es] Create docs/contributing/issues.md (#6088)

Signed-off-by: Diana Todea <diane.todea@gmail.com>
This commit is contained in:
Diana Todea 2025-02-14 00:20:12 +01:00 committed by GitHub
parent 62db0cbf29
commit e9b4922f4f
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 108 additions and 0 deletions

View File

@ -14,3 +14,5 @@ Muestreadores
muestreadores
monitoreo
multilenguaje
redireccionar
prerrellenada

View File

@ -0,0 +1,106 @@
---
title: Propuestas
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
default_lang_commit: 99f0ae5760038d51f9e9eb376bb428a2caca8167
---
## Solucionando una propuesta 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 [propuestas]({{% param _issues %}}).
2. Seleccione una propuesta en el que le gustaría trabajar, idealmente una que
se pueda solucionar en poco tiempo.
<!-- prettier-ignore -->
<a name="first-issue"></a>
{{% alert title="Contribuyendo por la primera vez? " %}}
Seleccione una propuesta con las siguientes etiquetas:
- [Good first issue]
- [Help wanted]
<!-- prettier-ignore -->
> **NOTA**: **_No_ asignamos propuestas** a aquellos que aún no hayan contribuido a la organización [OpenTelemetry
> organization][org], a menos que sean parte de un proceso de tutoria o onboarding.
{.mt-3}
<!-- prettier-ignore -->
[good first issue]: {{% param _issue %}}%22good+first+issue%22
[help wanted]: {{% param _issue %}}%3A%22help+wanted%22
[org]: https://github.com/open-telemetry
{{% /alert %}}
3. Lea los comentarios del problema, si los hay.
4. Pregunta a los mantenedores si la propuesta 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 y notifica a los mantenedores si surge
algún inconveniente.
7. Cuando este listo, [envia tu trabajo con un pull request](../pull-requests)
(PR).
## Reportar un problema
Si encuentras un error o quieres hacer unas sugerencias para mejorar el
contenido existente, abre una propuesta.
1. Haz click en el enlace **Crea una propuesta para la documentación** de
cualquier documento. Eso te va a redireccionar a una pagina de la propuesta
GitHub prerrellenada 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
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 funcionalidad, pero no estás seguro
de dónde debería ir, aún puedes presentar una propuesta. También puedes informar
errores y vulnerabilidades de seguridad.
1. Ve a [GitHub](https://github.com/open-telemetry/opentelemetry.io/issues/new/)
y selecciona **Nueva propuesta** dentro de la pestaña **Propuestas**.
1. Seleccione el tipo de problema que mejor se aplica a su solicitud o duda.
1. Rellene la plantilla.
1. Envia la propuesta.
### Como crear buenas propuestas
Tenga en cuenta lo siguiente al crear una propuesta:
- 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í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.
- 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.