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