diff --git a/docs/es/docs/help-fastapi.md b/docs/es/docs/help-fastapi.md new file mode 100644 index 000000000..94e178c01 --- /dev/null +++ b/docs/es/docs/help-fastapi.md @@ -0,0 +1,263 @@ +# Ayuda a FastAPI - Obtener Ayuda + +¿Te gusta **FastAPI**? + +¿Quieres ayudar a FastAPI, a otros usuarios y al autor? + +¿O te gustaría recibir ayuda con **FastAPI**? + +Hay formas muy sencillas de ayudar (varias implican sólo uno o dos clics). + +Y también hay varias formas de obtener ayuda. + +## Suscríbete al boletín + +Puedes suscribirte al (infrecuente) [Boletín de Noticias de **FastAPI y amigos**](newsletter.md){.internal-link target=_blank} para mantenerte actualizado sobre: + +* Noticias sobre FastAPI y amigos 🚀 +* Guías 📝 +* Características ✨ +* Cambios importantes 🚨 +* Consejos y trucos ✅ + +## Seguir FastAPI en X (Twitter) + +Siga a @fastapi en **X (Twitter)** para obtener las últimas noticias sobre **FastAPI **. 🐦 + +## Estrella a **FastAPI** en GitHub + +Puedes "star" a FastAPI en GitHub (haciendo clic en el botón de estrella en la parte superior derecha): https://github.com/tiangolo/fastapi. ⭐️ + +Al añadir una estrella, otros usuarios podrán encontrarlo más fácilmente y ver que ya ha sido útil para otros. + +## Observa el repositorio de GitHub para conocer los releases + +Puedes "watch" a FastAPI en GitHub (haciendo clic en el botón "watch" en la parte superior derecha): https://github.com/tiangolo/fastapi. 👀 + +Allí puede seleccionar "Releases only". + +Al hacerlo, recibirá notificaciones (en su correo electrónico) cada vez que haya una nueva release (una nueva versión) de **FastAPI** con correcciones de errores y nuevas funciones. + +## Conecta con el autor + +Puedes conectar conmigo (Sebastián Ramírez / `tiangolo`), el autor. + +Puedes: + +* Seguirme en **GitHub**. + * Ver otros proyectos de Código Abierto que he creado y que podrían ayudarte. + * Seguirme para ver cuando creo un nuevo proyecto de Código Abierto. +* Seguirme en **X (Twitter)** or Mastodon. + * Cuéntame cómo usas FastAPI (me encanta escuchar eso). + * Escucha cuando hago anuncios o lanzo nuevas herramientas. + * Puedes también seguir a @fastapi en X (Twitter) (una cuenta independiente). +* Conecta conmigo en **Linkedin**. + * Escucha cuando hago anuncios o lanzo nuevas herramientas (aunque uso X (Twitter) con más frecuencia 🤷‍♂). +* Lee lo que escribo (o sígueme) en **Dev.to** o **Medium**. + * Lee otras ideas, artículos y lee sobre las herramientas que he creado. + * Sígueme para ver cuando publique algo nuevo. + +## Publica sobre **FastAPI** + +Publica sobre **FastAPI** y déjanos saber a mí y a otros por qué te gusta. 🎉 + +Me encanta saber cómo se usa **FastAPI**, qué te ha gustado, en qué proyecto/empresa lo estás usando, etc. + +## Vota por FastAPI + +* Vota por **FastAPI** en Slant. +* Vota por **FastAPI** en AlternativeTo. +* Comenta tu uso de **FastAPI** en StackShare. + +## Ayuda a otros con preguntas en GitHub + +Puedes intentar ayudar a otros con sus preguntas en: + +* Discusiones de GitHub +* GitHub Issues + +En muchos casos, es posible que ya sepa la respuesta a esas preguntas. 🤓 + +Si estás ayudando a muchas personas con sus preguntas, te convertirás en un [FastAPI Experto](fastapi-people.md#expertos){.internal-link target=_blank} oficial. 🎉 + +Sólo recuerda, el punto más importante es: trata de ser amable. La gente viene con sus frustraciones y en muchos casos no preguntan de la mejor manera, pero trata lo mejor que puedes de ser amable. 🤗 + +La idea es que la comunidad **FastAPI** sea amable y acogedora. Al mismo tiempo, no aceptes acoso ni comportamientos irrespetuosos hacia los demás. Tenemos que cuidarnos unos a otros. + +--- + +A continuación se explica cómo ayudar a otros con preguntas (en debates o problemas): + +### Entiende la pregunta + +* Comprueba si puedes comprender cuál es el **propósito** y el caso de uso de la persona que pregunta. + +* Luego verifica si la pregunta (la gran mayoría son preguntas) es **clara**. + +* En muchos casos la pregunta que se hace es sobre una solución imaginaria del usuario, pero podría haber una **mejor**. Si puede comprender mejor el problema y el caso de uso, es posible que pueda sugerir una **solución alternativa** mejor. + +* Si no entiendes la pregunta, pide más **detalles**. + +### Reproduce el problema + +Para la mayoría de los casos y la mayoría de las preguntas hay algo relacionado con el **código original** de la persona. + +En muchos casos sólo copiarán un fragmento del código, pero eso no es suficiente para **reproducir el problema**. + +* Puedes pedirles que proporcionen un ejemplo mínimo y reproducible, que puedas **copiar-pegar** y ejecutar localmente para ver el mismo error o comportamiento que ellos están viendo, o para comprender mejor su caso de uso. + +* Si te sientes demasiado generoso, puedes intentar **crear un ejemplo** similar tú mismo, basándote únicamente en la descripción del problema. Sólo ten en cuenta que esto puede llevar mucho tiempo y sería mejor pedirles que aclaren el problema primero. + +### Sugiere soluciones + +* Luego de poder entender la pregunta, podrás darles una posible **respuesta**. + +* En muchos casos, es mejor comprender su **problema subyacente o caso de uso**, porque podría haber una mejor manera de resolverlo que lo que están tratando de hacer. + +### Pregunta para cerrar + +Si responden, hay muchas posibilidades de que hayas resuelto su problema, felicidades, **¡eres un héroe**! 🦸 + +* Ahora, si eso resolvió su problema, puedes pedirles que: + + * En Discusiones de GitHub: marque el comentario como **respuesta**. + * En Issues de GitHub: **cerrar** el Issue. + +## Observa el repositorio de GitHub + +Puedes "watch" a FastAPI en GitHub (haciendo clic en el botón "watch" en la parte superior derecha): https://github.com/tiangolo/fastapi. 👀 + +Si selecciona "Watching" en lugar de "Releases only", recibirá notificaciones cuando alguien cree un nuevo problema o pregunta. También puede especificar que solo desea recibir notificaciones sobre nuevas issues, discusiones, PRs, etc. + +Luego puedes intentar ayudarlos a resolver esas preguntas. + +## Hacer Preguntas + +Puedes crear una nueva pregunta en el repositorio de GitHub, por ejemplo: + +* Haga una **pregunta** o pregunte sobre un **problema**. +* Sugerir una nueva **característica**. + +**Nota**: si lo haces, te pediré que también ayudes a otros. 😉 + +## Revisa Pull Requests + +Puedes ayudarme a revisar los pull requests de otros. + +Nuevamente, intenta todo lo posible por ser amable. 🤗 + +--- + +Esto es lo que debe tener en cuenta y cómo revisar un pull requests: + +### Entiende el problema + +* Primero, asegúrate de **comprender el problema** que el pull request intenta resolver. Es posible que tenga una discusión más larga en una discusión o issue de GitHub. + +* También existe una buena posibilidad de que el pull request no sea realmente necesario porque el problema se puede resolver de una **manera diferente**. Entonces puedes sugerir o preguntar sobre eso. + +### No te preocupes por el estilo + +* No se preocupe demasiado por cosas como los estilos de mensajes de confirmación, forzaré y mezclaré personalizando el commit manualmente. + +* Tampoco te preocupes por las reglas de estilo, ya existen herramientas automatizadas que lo comprueban. + +Y si hay algún otro estilo o necesidad de coherencia, lo pediré directamente o agregaré commits con los cambios necesarios. + +### Comprueba el código + +* Verifica y lee el código, mira si tiene sentido, **ejecútelo localmente** y mira si realmente resuelve el problema. + +* Luego **comenta** diciendo que hiciste eso, así sabré que realmente lo comprobaste. + +!!! info "Información" + Desafortunadamente, no puedo simplemente confiar en los PRs que solo tienen varias aprobaciones. + + Varias veces ha sucedido que hay PRs con 3, 5 o más aprobaciones, probablemente porque la descripción es atractiva, pero cuando reviso los PRs, en realidad están rotos, tienen un error o no resuelven el problema que dicen. resolver. 😅 + + Por lo tanto, es muy importante que leas y ejecutes el código y que me dejes saber en los comentarios que lo hiciste. 🤓 + +* Si el PR se puede simplificar de alguna manera, puedes pedirlo, pero no hay necesidad de ser demasiado exigente, puede haber muchos puntos de vista subjetivos (y yo también tendré el mío 🙈), así que es mejor si puedes concentrarte en las cosas fundamentales. + +### Pruebas + +* Ayúdame a comprobar que el PR tenga **pruebas**. + +* Comprueba que las pruebas **fallan** antes del PR. 🚨 + +* Luego comprueba que las pruebas **pasan** después del PR. ✅ + +* Muchos PRs no tienen pruebas, puedes **recordarles** que agreguen pruebas, o incluso puedes **sugerir** algunas pruebas tú mismo. Esa es una de las cosas que consume más tiempo y puedes ayudar mucho con eso. + +* Luego comenta también lo que probaste, así sabré que lo revisaste. 🤓 + +## Crea un Pull Request + +Puedes [contribuir](contributing.md){.internal-link target=_blank} al código fuente con Pull Requests, por ejemplo: + +* Para corregir un error tipográfico encontrado en la documentación. +* Para compartir un artículo, vídeo o podcast que haya creado o encontrado sobre FastAPI editando este archivo. + * Asegúrate de agregar tu enlace al inicio de la sección correspondiente. +* Para ayudar a [traducir la documentación](contributing.md#traducciones){.internal-link target=_blank} a su idioma. + * También puedes ayudar a revisar las traducciones creadas por otros. +* Proponer nuevas secciones de documentación. +* Para solucionar un problema/error existente. + * Asegúrate de agregar pruebas. +* Para agregar una nueva característica. + * Asegúrate de agregar pruebas. + * Asegúrate de agregar documentación si es relevante. + +## Ayuda a mantener FastAPI + +¡Ayúdame a mantener **FastAPI**! 🤓 + +Hay mucho trabajo por hacer y, en su mayor parte, **TÚ** puedes hacerlo. + +Las principales tareas que puedes realizar ahora mismo son: + +* [Ayuda a otros con preguntas en GitHub](#ayuda-a-otros-con-preguntas-en-github){.internal-link target=_blank} (ver la sección anterior). +* [Revisa Pull Requests](#revisa-pull-requests){.internal-link target=_blank} (ver la sección anterior). + +Esas dos tareas son las que **consumen más tiempo**. Ese es el trabajo principal de mantener FastAPI. + +Si puedes ayudarme con eso, **me estás ayudando a mantener FastAPI** y asegurarte de que siga **avanzando más rápido y mejor**. 🚀 + +## Únete al chat + +Únete al 👥 servidor de chat de Discord 👥 y pasa el rato con otros miembros de la comunidad FastAPI. + +!!! tip "Consejo" + Si tienes preguntas, hazlas en Discusiones de GitHub , hay muchas más posibilidades de que reciba ayuda de los [Expertos de FastAPI](fastapi-people.md#expertos){.internal-link target=_blank}. + + Utilice el chat sólo para otras conversaciones generales. + +### No uses el chat para preguntas + +Ten en cuenta que como los chats permiten una "conversación más libre", es fácil hacer preguntas demasiado generales y más difíciles de responder, por lo que es posible que no recibas respuestas. + +En GitHub, la plantilla te guiará para escribir la pregunta correcta para que puedas obtener más fácilmente una buena respuesta o incluso resolver el problema tú mismo incluso antes de preguntar. Y en GitHub puedo asegurarme de responder siempre todo, aunque me lleve algo de tiempo. Personalmente no puedo hacer eso con los sistemas de chat. 😅 + +Las conversaciones en los sistemas de chat tampoco se pueden buscar tan fácilmente como en GitHub, por lo que las preguntas y respuestas pueden perderse en la conversación. Y solo los que están en GitHub cuentan para convertirse en un [Experto de FastAPI](fastapi-people.md#expertos){.internal-link target=_blank}, por lo que lo más probable es que recibas más atención en GitHub. + +Por otro lado, hay miles de usuarios en los sistemas de chat, por lo que es muy probable que encuentres a alguien con quien hablar allí, casi todo el tiempo. 😄 + +## Patrocinar al autor + +También puedes apoyar financieramente al autor (yo) a través de Patrocinadores de GitHub. + +Allí podrías invitarme a un café ☕️ para darme las gracias. 😄 + +Y también puedes convertirte en patrocinador Plata u Oro de FastAPI. 🏅🎉 + +## Patrocine las herramientas que impulsan FastAPI + +Como ha visto en la documentación, FastAPI se apoya en los gigantes Starlette y Pydantic. + +También puedes patrocinar: + +* Samuel Colvin (Pydantic) +* Encode (Starlette, Uvicorn) + +--- + +Gracias! 🚀