Skip to content

Commit e9b4922

Browse files
authored
feat: [es] Create docs/contributing/issues.md (open-telemetry#6088)
Signed-off-by: Diana Todea <[email protected]>
1 parent 62db0cb commit e9b4922

File tree

2 files changed

+108
-0
lines changed

2 files changed

+108
-0
lines changed

.cspell/es-palabras.txt

+2
Original file line numberDiff line numberDiff line change
@@ -14,3 +14,5 @@ Muestreadores
1414
muestreadores
1515
monitoreo
1616
multilenguaje
17+
redireccionar
18+
prerrellenada
+106
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,106 @@
1+
---
2+
title: Propuestas
3+
description:
4+
Cómo solucionar un problema existente o informar un error, un riesgo de
5+
seguridad o una posible mejora.
6+
weight: 10
7+
_issues: https://github.com/open-telemetry/opentelemetry.io/issues
8+
_issue: https://github.com/open-telemetry/opentelemetry.io/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A
9+
default_lang_commit: 99f0ae5760038d51f9e9eb376bb428a2caca8167
10+
---
11+
12+
## Solucionando una propuesta existente
13+
14+
Una de las mejores maneras de contribuir a mejorar la documentación de
15+
OpenTelemetry (OTel) es solucionando un problema ya identificado.
16+
17+
1. Navegar por la lista de [propuestas]({{% param _issues %}}).
18+
2. Seleccione una propuesta en el que le gustaría trabajar, idealmente una que
19+
se pueda solucionar en poco tiempo.
20+
21+
<!-- prettier-ignore -->
22+
<a name="first-issue"></a>
23+
{{% alert title="Contribuyendo por la primera vez? " %}}
24+
25+
Seleccione una propuesta con las siguientes etiquetas:
26+
27+
- [Good first issue]
28+
- [Help wanted]
29+
30+
<!-- prettier-ignore -->
31+
> **NOTA**: **_No_ asignamos propuestas** a aquellos que aún no hayan contribuido a la organización [OpenTelemetry
32+
> organization][org], a menos que sean parte de un proceso de tutoria o onboarding.
33+
{.mt-3}
34+
35+
<!-- prettier-ignore -->
36+
[good first issue]: {{% param _issue %}}%22good+first+issue%22
37+
[help wanted]: {{% param _issue %}}%3A%22help+wanted%22
38+
[org]: https://github.com/open-telemetry
39+
40+
{{% /alert %}}
41+
42+
3. Lea los comentarios del problema, si los hay.
43+
4. Pregunta a los mantenedores si la propuesta sigue siendo relevante y aclara
44+
cualquier duda publicando un comentario.
45+
5. Comparte tu intención de trabajar en el tema agregando un comentario a este
46+
efecto.
47+
6. Trabaja para solucionar el problema y notifica a los mantenedores si surge
48+
algún inconveniente.
49+
7. Cuando este listo, [envia tu trabajo con un pull request](../pull-requests)
50+
(PR).
51+
52+
## Reportar un problema
53+
54+
Si encuentras un error o quieres hacer unas sugerencias para mejorar el
55+
contenido existente, abre una propuesta.
56+
57+
1. Haz click en el enlace **Crea una propuesta para la documentación** de
58+
cualquier documento. Eso te va a redireccionar a una pagina de la propuesta
59+
GitHub prerrellenada con algunos encabezados.
60+
2. Describa el problema o la sugerencia de mejora. Proporcione tantos detalles
61+
como pueda.
62+
3. Haz click en **Submit new issue**.
63+
64+
Después de enviar el problema, verifique su problema de vez en cuando o active
65+
las notificaciones de GitHub. Puede que pasen algunos días hasta que los
66+
mantenedores respondan. Los revisores y otros miembros de la comunidad pueden
67+
hacer preguntas antes de poder tomar medidas sobre su problema.
68+
69+
## Sugerir nuevos contenidos o funciones
70+
71+
Si tienes una idea para un nuevo contenido o funcionalidad, pero no estás seguro
72+
de dónde debería ir, aún puedes presentar una propuesta. También puedes informar
73+
errores y vulnerabilidades de seguridad.
74+
75+
1. Ve a [GitHub](https://github.com/open-telemetry/opentelemetry.io/issues/new/)
76+
y selecciona **Nueva propuesta** dentro de la pestaña **Propuestas**.
77+
78+
1. Seleccione el tipo de problema que mejor se aplica a su solicitud o duda.
79+
80+
1. Rellene la plantilla.
81+
82+
1. Envia la propuesta.
83+
84+
### Como crear buenas propuestas
85+
86+
Tenga en cuenta lo siguiente al crear una propuesta:
87+
88+
- Proporcione una descripción clara del problema. Describa específicamente qué
89+
falta, qué está desactualizado, qué está mal o qué necesita mejorarse.
90+
- Explique el impacto específico que tiene el problema en los usuarios.
91+
- Limite el alcance de un problema determinado a una unidad de trabajo
92+
razonable. En el caso de problemas de gran alcance, divídelos en tareas más
93+
pequeñas. Por ejemplo, "Corregir la documentación de seguridad" es demasiado
94+
amplio, pero "Agregar detalles en la sección 'Restringir el acceso a la red'"
95+
es lo suficientemente específico como para que se pueda llevar a cabo una
96+
acción.
97+
- Busque los problemas existentes para ver si hay algo relacionado o similar al
98+
nuevo problema.
99+
- Si el nuevo problema se relaciona con otro problema o solicitud de
100+
incorporación de cambios, haga referencia a él por su URL completa o por el
101+
número del problema o solicitud de incorporación de cambios precedido por el
102+
carácter `#`, por ejemplo `Introducido por #987654`.
103+
- Sigue el
104+
[Código de conducta](https://github.com/open-telemetry/community/blob/main/code-of-conduct.md).
105+
Respete a sus compañeros colaboradores. Por ejemplo, decir "Los documentos son
106+
terribles" no es un comentario útil ni cortés.

0 commit comments

Comments
 (0)