Ayuda a FastAPI - Consigue Ayuda¶

¿Te gustaFastAPI?

¿Te gustaría ayudar a FastAPI, a otros usuarios y al autor?

¿O te gustaría conseguir ayuda conFastAPI?

Hay formas muy sencillas de ayudar (varias implican solo uno o dos clics).

Y también hay varias formas de conseguir ayuda.

Suscríbete al boletín¶

Puedes suscribirte al (esporádico) boletínFastAPI and friends para mantenerte al día sobre:

• Noticias sobre FastAPI y amigos 🚀
• Guías 📝
• Funcionalidades ✨
• Cambios importantes 🚨
• Consejos y trucos ✅

Sigue a FastAPI en X (Twitter)¶

Sigue a @fastapi enX (Twitter) para obtener las últimas noticias sobreFastAPI. 🐦

Dale una estrella aFastAPI en GitHub¶

Puedes "darle una estrella" a FastAPI en GitHub (haciendo clic en el botón de estrella en la parte superior derecha):https://github.com/fastapi/fastapi. ⭐️

Al agregar 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 lanzamientos¶

Puedes "observar" FastAPI en GitHub (haciendo clic en el botón "watch" en la parte superior derecha):https://github.com/fastapi/fastapi. 👀

Allí puedes seleccionar "Releases only".

Al hacerlo, recibirás notificaciones (en tu email) cada vez que haya un nuevo lanzamiento (una nueva versión) deFastAPI con correcciones de bugs y nuevas funcionalidades.

Conéctate con el autor¶

Puedes conectarconmigo (Sebastián Ramírez /tiangolo), el autor.

Puedes:

• Seguirme enGitHub.
  • Ver otros proyectos de Código Abierto que he creado y que podrían ayudarte.
  • Seguirme para ver cuándo creo un nuevo proyecto de Código Abierto.
• Seguirme enX (Twitter) oMastodon.
  • Contarme cómo usas FastAPI (me encanta oír eso).
  • Enterarte cuando hago anuncios o lanzo nuevas herramientas.
  • También puedesseguir @fastapi en X (Twitter) (una cuenta aparte).
• Seguirme enLinkedIn.
  • Enterarte cuando hago anuncios o lanzo nuevas herramientas (aunque uso X (Twitter) más a menudo 🤷‍♂).
• Leer lo que escribo (o seguirme) enDev.to oMedium.
  • Leer otras ideas, artículos, y leer sobre las herramientas que he creado.
  • Seguirme para leer lo que publico nuevo.

Twittea sobreFastAPI¶

Twittea sobreFastAPI y dime a mí y a otros por qué te gusta. 🎉

Me encanta escuchar cómo se está utilizandoFastAPI, qué te ha gustado, en qué proyecto/empresa lo estás usando, etc.

Vota por FastAPI¶

• Vota porFastAPI en Slant.
• Vota porFastAPI en AlternativeTo.
• Di que usasFastAPI en StackShare.

Ayuda a otros con preguntas en GitHub¶

Puedes intentar ayudar a otros con sus preguntas en:

• GitHub Discussions
• GitHub Issues

En muchos casos, probablemente ya conozcas la respuesta a esas preguntas. 🤓

Si estás ayudando mucho a la gente con sus preguntas, te convertirás en unFastAPI Expert oficial. 🎉

Solo recuerda, el punto más importante es: trata de ser amable. La gente llega con sus frustraciones y, en muchos casos, no pregunta de la mejor manera, pero haz todo lo posible por ser amable. 🤗

La idea es que la comunidad deFastAPI sea amable y acogedora. Al mismo tiempo, no aceptes acoso o comportamiento irrespetuoso hacia los demás. Tenemos que cuidarnos unos a otros.

Aquí te explico cómo ayudar a otros con preguntas (en discusiones o issues):

Entiende la pregunta¶

• Revisa si puedes entender cuál es elpropósito y el caso de uso de la persona que pregunta.

• Luego revisa si la pregunta (la gran mayoría son preguntas) esclara.

• En muchos casos, la pregunta planteada es sobre una solución imaginaria del usuario, pero podría haber unamejor. Si puedes entender mejor el problema y el caso de uso, podrías sugerir una mejorsolución alternativa.

• Si no puedes entender la pregunta, pide másdetalles.

Reproduce el problema¶

En la mayoría de los casos y preguntas hay algo relacionado con elcódigo original de la persona.

En muchos casos solo copiarán un fragmento del código, pero eso no es suficiente parareproducir el problema.

• Puedes pedirles que proporcionen unejemplo mínimo, reproducible, que puedascopiar-pegar y ejecutar localmente para ver el mismo error o comportamiento que están viendo, o para entender mejor su caso de uso.

• Si te sientes muy generoso, puedes intentarcrear un ejemplo así tú mismo, solo basado en la descripción del problema. Solo ten en cuenta que esto podría llevar mucho tiempo y podría ser mejor pedirles que aclaren el problema primero.

Sugerir soluciones¶

• Después de poder entender la pregunta, puedes darles una posiblerespuesta.

• En muchos casos, es mejor entender suproblema subyacente o caso de uso, porque podría haber una mejor manera de resolverlo que lo que están intentando hacer.

Pide cerrar¶

Si responden, hay una alta probabilidad de que hayas resuelto su problema, felicidades, ¡eres un héroe! 🦸

• Ahora, si eso resolvió su problema, puedes pedirles que:

  • En GitHub Discussions: marquen el comentario como larespuesta.
  • En GitHub Issues:cierren el issue.

Observa el repositorio de GitHub¶

Puedes "observar" FastAPI en GitHub (haciendo clic en el botón "watch" en la parte superior derecha):https://github.com/fastapi/fastapi. 👀

Si seleccionas "Watching" en lugar de "Releases only", recibirás notificaciones cuando alguien cree un nuevo issue o pregunta. También puedes especificar que solo deseas que te notifiquen sobre nuevos issues, discusiones, PRs, etc.

Luego puedes intentar ayudarlos a resolver esas preguntas.

Haz preguntas¶

Puedescrear una nueva pregunta en el repositorio de GitHub, por ejemplo, para:

• Hacer unapregunta o preguntar sobre unproblema.
• Sugerir una nuevafuncionalidad.

Nota: si lo haces, entonces te voy a pedir que también ayudes a otros. 😉

Revisa Pull Requests¶

Puedes ayudarme a revisar pull requests de otros.

De nuevo, por favor, haz tu mejor esfuerzo por ser amable. 🤗

Aquí está lo que debes tener en cuenta y cómo revisar un pull request:

Entiende el problema¶

• Primero, asegúrate deentender el problema que el pull request está intentando resolver. Podría tener una discusión más larga en una GitHub Discussion o issue.

• También hay una buena posibilidad de que el pull request no sea realmente necesario porque el problema se puede resolver de una maneradiferente. Entonces puedes sugerir o preguntar sobre eso.

No te preocupes por el estilo¶

• No te preocupes demasiado por cosas como los estilos de los mensajes de commit, yo haré squash y merge personalizando el commit manualmente.

• Tampoco te preocupes por las reglas de estilo, hay herramientas automatizadas verificando eso.

Y si hay alguna otra necesidad de estilo o consistencia, pediré directamente eso, o agregaré commits encima con los cambios necesarios.

Revisa el código¶

• Revisa y lee el código, ve si tiene sentido,ejecútalo localmente y ve si realmente resuelve el problema.

• Luegocomenta diciendo que hiciste eso, así sabré que realmente lo revisaste.

• Si el PR se puede simplificar de alguna manera, puedes pedir eso, pero no hay necesidad de ser demasiado exigente, podría haber muchos puntos de vista subjetivos (y yo tendré el mío también 🙈), así que es mejor si puedes centrarte en las cosas fundamentales.

Tests¶

• Ayúdame a verificar que el PR tengatests.

• Verifica que los testsfallen antes del PR. 🚨

• Luego verifica que los testspasen después del PR. ✅

• Muchos PRs no tienen tests, puedesrecordarles que agreguen tests, o incluso puedessugerir algunos tests tú mismo. Eso es una de las cosas que consume más tiempo y puedes ayudar mucho con eso.

• Luego también comenta lo que intentaste, de esa manera sabré que lo revisaste. 🤓

Crea un Pull Request¶

Puedescontribuir al código fuente con Pull Requests, por ejemplo:

• Para corregir un error tipográfico que encontraste en la documentación.
• Para compartir un artículo, video o podcast que creaste o encontraste sobre FastAPIeditando este archivo.
  • Asegúrate de agregar tu enlace al inicio de la sección correspondiente.
• Para ayudar atraducir la documentación a tu idioma.
  • También puedes ayudar a revisar las traducciones creadas por otros.
• Para proponer nuevas secciones de documentación.
• Para corregir un issue/bug existente.
  • Asegúrate de agregar tests.
• Para agregar una nueva funcionalidad.
  • Asegúrate de agregar tests.
  • Asegúrate de agregar documentación si es relevante.

Ayuda a Mantener FastAPI¶

¡Ayúdame a mantenerFastAPI! 🤓

Hay mucho trabajo por hacer, y para la mayoría de ello,TÚ puedes hacerlo.

Las tareas principales que puedes hacer ahora son:

• Ayudar a otros con preguntas en GitHub (ver la sección arriba).
• Revisar Pull Requests (ver la sección arriba).

Esas dos tareas son las queconsumen más tiempo. Ese es el trabajo principal de mantener FastAPI.

Si puedes ayudarme con eso,me estás ayudando a mantener FastAPI y asegurando que sigaavanzando más rápido y mejor. 🚀

Únete al chat¶

Únete al servidor de chat 👥Discord 👥 y charla con otros en la comunidad de FastAPI.

No uses el chat para preguntas¶

Ten en cuenta que dado que los chats permiten una "conversación más libre", es fácil hacer preguntas que son 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 por ti mismo antes de preguntar. Y en GitHub puedo asegurarme de responder siempre todo, incluso si lleva tiempo. No puedo hacer eso personalmente con los sistemas de chat. 😅

Las conversaciones en los sistemas de chat tampoco son tan fácilmente buscables como en GitHub, por lo que las preguntas y respuestas podrían perderse en la conversación. Y solo las que están en GitHub cuentan para convertirse en unFastAPI Expert, por lo que probablemente recibirás más atención en GitHub.

Por otro lado, hay miles de usuarios en los sistemas de chat, por lo que hay muchas posibilidades de que encuentres a alguien con quien hablar allí, casi todo el tiempo. 😄

Hazte sponsor del autor¶

Si tuproducto/empresa depende de o está relacionado conFastAPI y quieres llegar a sus usuarios, puedes hacerte sponsor del autor (de mí) a través deGitHub sponsors. Según el nivel, podrías obtener algunos beneficios extra, como una insignia en la documentación. 🎁

¡Gracias! 🚀