feat: [es] Create docs/contributing/issues.md (#6088)
Signed-off-by: Diana Todea <diane.todea@gmail.com>
This commit is contained in:
parent
62db0cbf29
commit
e9b4922f4f
|
@ -14,3 +14,5 @@ Muestreadores
|
|||
muestreadores
|
||||
monitoreo
|
||||
multilenguaje
|
||||
redireccionar
|
||||
prerrellenada
|
||||
|
|
|
@ -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.
|
Loading…
Reference in New Issue