Add Spanish translation for docs/es/docs/help-fastapi.md

- Version >= 0.108.0

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)
+
+<a href="https://twitter.com/fastapi" class="external-link" target="_blank">Siga a @fastapi en **X (Twitter)**</a> para obtener las últimas noticias sobre **FastAPI **. 🐦
+
+## Estrella a **FastAPI** en GitHub
+
+Puedes <abbr title="poner estrella">"star"</abbr> a FastAPI en GitHub (haciendo clic en el botón de estrella en la parte superior derecha): <a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">https://github.com/tiangolo/fastapi</a>. ⭐️
+
+Al añadir una estrella, otros usuarios podrán encontrarlo más fácilmente y ver que ya ha sido útil para otros.
+
+## <abbr title="en GitHub es darle segumiento a un proyecto. También conocido en español como: Observar">Observa</abbr> el repositorio de GitHub para conocer los <abbr title="también conocido en español como: lanzamientos, liberaciones">releases</abbr>
+
+Puedes <abbr title="en GitHub es darle segumiento a un proyecto. También conocido en español como: Observar">"watch"</abbr> a FastAPI en GitHub (haciendo clic en el botón "watch" en la parte superior derecha): <a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">https://github.com/tiangolo/fastapi</a>. 👀
+
+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 <a href="https://tiangolo.com" class="external-link" target="_blank"> (Sebastián Ramírez / `tiangolo`)</a>, el autor.
+
+Puedes:
+
+* <a href="https://github.com/tiangolo" class="external-link" target="_blank">Seguirme en **GitHub**</a>.
+    * 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.
+* <a href="https://twitter.com/tiangolo" class="external-link" target="_blank">Seguirme en **X (Twitter)**</a> or <a href="https://fosstodon.org/@tiangolo" class="external-link" target="_blank">Mastodon</a>.
+    * Cuéntame cómo usas FastAPI (me encanta escuchar eso).
+    * Escucha cuando hago anuncios o lanzo nuevas herramientas.
+    * Puedes también <a href="https://twitter.com/fastapi" class="external-link" target="_blank">seguir a @fastapi en X (Twitter)</a> (una cuenta independiente).
+* <a href="https://www.linkedin.com/in/tiangolo/" class="external-link" target="_blank">Conecta conmigo en **Linkedin**</a>.
+    * Escucha cuando hago anuncios o lanzo nuevas herramientas (aunque uso X (Twitter) con más frecuencia 🤷‍♂).
+* Lee lo que escribo (o sígueme) en <a href="https://dev.to/tiangolo" class="external-link" target="_blank">**Dev.to**</a> o <a href="https://medium.com/@tiangolo" class="external-link" target="_blank">**Medium**</a>.
+    * Lee otras ideas, artículos y lee sobre las herramientas que he creado.
+    * Sígueme para ver cuando publique algo nuevo.
+
+## Publica sobre **FastAPI**
+
+<a href="https://twitter.com/compose/tweet?text=I'm loving @fastapi because... https://github.com/tiangolo/fastapi" class="external-link" target="_blank">Publica sobre **FastAPI**</a> 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
+
+* <a href="https://www.slant.co/options/34241/~fastapi-review" class="external-link" target="_blank">Vota por **FastAPI** en Slant</a>.
+* <a href="https://alternativeto.net/software/fastapi/" class="external-link" target="_blank">Vota por **FastAPI** en AlternativeTo</a>.
+* <a href="https://stackshare.io/pypi-fastapi" class="external-link" target="_blank">Comenta tu uso de **FastAPI** en StackShare</a>.
+
+## Ayuda a otros con preguntas en GitHub
+
+Puedes intentar ayudar a otros con sus preguntas en:
+
+* <a href="https://github.com/tiangolo/fastapi/discussions/categories/questions?discussions_q=category%3AQuestions+is%3Aunanswered" class="external-link" target="_blank">Discusiones de GitHub</a>
+* <a href="https://github.com/tiangolo/fastapi/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Aquestion+-label%3Aanswered+" class="external-link" target="_blank">GitHub Issues</a>
+
+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 <a href="https://stackoverflow.com/help/minimal-reproducible-example" class="external-link" target="_blank">ejemplo mínimo y reproducible</a >, 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.
+
+## <abbr title="en GitHub es darle segumiento a un proyecto. También conocido en español como: Observar">Observa</abbr> el repositorio de GitHub
+
+Puedes <abbr title="en GitHub es darle segumiento a un proyecto. También conocido en español como: Observar">"watch"</abbr> a FastAPI en GitHub (haciendo clic en el botón "watch" en la parte superior derecha): <a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">https://github.com/tiangolo/fastapi</a>. 👀
+
+Si selecciona <abbr title="en GitHub es darle segumiento a un proyecto. También conocido en español como: Observando">"Watching"</abbr> en lugar de <abbr title="en GitHub también conocido en español como: Solo lanzamientos">"Releases only"</abbr>, 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 <a href="https://github.com/tiangolo/fastapi/discussions/new?category=questions" class="external-link" target="_blank">crear una nueva pregunta</a> 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 <a href="https://github.com/tiangolo/fastapi/edit/master/docs/en/data/external_links.yml" class="external-link" target="_blank">editando este archivo</a>.
+    * 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 👥 <a href="https://discord.gg/VQjSZaeJmf" class="external-link" target="_blank">servidor de  chat de Discord</a> 👥 y pasa el rato con otros miembros de la comunidad FastAPI.
+
+!!! tip "Consejo"
+    Si tienes preguntas, hazlas en <a href="https://github.com/tiangolo/fastapi/discussions/new?category=questions" class="external-link" target="_blank">Discusiones de GitHub</a> , 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 <a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">Patrocinadores de GitHub</a>.
+
+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:
+
+* <a href="https://github.com/sponsors/samuelcolvin" class="external-link" target="_blank">Samuel Colvin (Pydantic)</a>
+* <a href="https://github.com/sponsors/encode" class="external-link" target="_blank">Encode (Starlette, Uvicorn)</a>
+
+---
+
+Gracias! 🚀