update help-fastapi.md

docs/pt/docs/help-fastapi.md

@@ -1,149 +1,256 @@
-# Ajuda FastAPI - Obter Ajuda
+# Ajude o FastAPI - Obtenha ajuda { #help-fastapi-get-help }
 
 Você gosta do **FastAPI**?
 
-Você gostaria de ajudar o FastAPI, outros usários, e o autor?
+Você gostaria de ajudar o FastAPI, outras pessoas usuárias e o autor?
 
-Ou você gostaria de obter ajuda relacionada ao **FastAPI**??
+Ou você gostaria de obter ajuda com o **FastAPI**?
 
-Existem métodos muito simples de ajudar (A maioria das ajudas podem ser feitas com um ou dois cliques).
+Há maneiras muito simples de ajudar (várias envolvem apenas um ou dois cliques).
 
-E também existem vários modos de se conseguir ajuda.
+E também há várias formas de obter ajuda.
 
-## Inscreva-se na newsletter
+## Assine a newsletter { #subscribe-to-the-newsletter }
 
-Você pode se inscrever (pouco frequente) [**FastAPI e amigos** newsletter](newsletter.md){.internal-link target=_blank} para receber atualizações:
+Você pode assinar a (infrequente) [newsletter do **FastAPI and friends**](newsletter.md){.internal-link target=_blank} para ficar por dentro de:
 
 * Notícias sobre FastAPI e amigos 🚀
 * Tutoriais 📝
-* Recursos ✨
-* Mudanças de última hora 🚨
-* Truques e dicas ✅
+* Funcionalidades ✨
+* Mudanças incompatíveis 🚨
+* Dicas e truques ✅
 
-## Siga o FastAPI no X (Twitter)
+## Siga o FastAPI no X (Twitter) { #follow-fastapi-on-x-twitter }
 
 <a href="https://x.com/fastapi" class="external-link" target="_blank">Siga @fastapi no **X (Twitter)**</a> para receber as últimas notícias sobre o **FastAPI**. 🐦
 
-## Favorite o **FastAPI** no GitHub
+## Dê uma estrela ao **FastAPI** no GitHub { #star-fastapi-in-github }
 
-Você pode "favoritar" o FastAPI no GitHub (clicando na estrela no canto superior direito): <a href="https://github.com/fastapi/fastapi" class="external-link" target="_blank">https://github.com/fastapi/fastapi</a>. ⭐️
+Você pode “marcar com estrela” o FastAPI no GitHub (clicando no botão de estrela no canto superior direito): <a href="https://github.com/fastapi/fastapi" class="external-link" target="_blank">https://github.com/fastapi/fastapi</a>. ⭐️
 
-Favoritando, outros usuários poderão encontrar mais facilmente e verão que já foi útil para muita gente.
+Ao adicionar uma estrela, outras pessoas conseguirão encontrá-lo com mais facilidade e verão que já foi útil para muita gente.
 
-## Acompanhe novos updates no repositorio do GitHub
+## Acompanhe o repositório no GitHub para lançamentos { #watch-the-github-repository-for-releases }
 
-Você pode "acompanhar" (watch) o FastAPI no GitHub (clicando no botão com um "olho" no canto superior direito): <a href="https://github.com/fastapi/fastapi" class="external-link" target="_blank">https://github.com/fastapi/fastapi</a>. 👀
+Você pode “acompanhar” (watch) o FastAPI no GitHub (clicando no botão “watch” no canto superior direito): <a href="https://github.com/fastapi/fastapi" class="external-link" target="_blank">https://github.com/fastapi/fastapi</a>. 👀
 
-Podendo selecionar apenas "Novos Updates".
+Lá você pode selecionar “Apenas lançamentos” (Releases only).
 
-Fazendo isto, serão enviadas notificações (em seu email) sempre que tiver novos updates (uma nova versão) com correções de bugs e novos recursos no **FastAPI**
+Fazendo isso, você receberá notificações (no seu email) sempre que houver um novo lançamento (uma nova versão) do **FastAPI** com correções de bugs e novas funcionalidades.
 
-## Conect-se com o autor
+## Conecte-se com o autor { #connect-with-the-author }
 
 Você pode se conectar <a href="https://tiangolo.com" class="external-link" target="_blank">comigo (Sebastián Ramírez / `tiangolo`)</a>, o autor.
 
 Você pode:
 
-* <a href="https://github.com/tiangolo" class="external-link" target="_blank">Me siga no **GitHub**</a>.
-    * Ver também outros projetos Open Source criados por mim que podem te ajudar.
-    * Me seguir para saber quando um novo projeto Open Source for criado.
-* <a href="https://x.com/tiangolo" class="external-link" target="_blank">Me siga no **X (Twitter)**</a>.
-    * Me dizer o motivo pelo o qual você está usando o FastAPI(Adoro ouvir esse tipo de comentário).
-    * Saber quando eu soltar novos anúncios ou novas ferramentas.
-    * Também é possivel <a href="https://x.com/fastapi" class="external-link" target="_blank">seguir o @fastapi no X (Twitter)</a> (uma conta aparte).
-* <a href="https://www.linkedin.com/in/tiangolo/" class="external-link" target="_blank">Conect-se comigo no **Linkedin**</a>.
-    * Saber quando eu fizer novos anúncios ou novas ferramentas (apesar de que uso o X (Twitter) com mais frequência 🤷‍♂).
-* Ler meus artigos (ou me seguir) no <a href="https://dev.to/tiangolo" class="external-link" target="_blank">**Dev.to**</a> ou no <a href="https://medium.com/@tiangolo" class="external-link" target="_blank">**Medium**</a>.
-    * Ficar por dentro de novas ideias, artigos, e ferramentas criadas por mim.
-    * Me siga para saber quando eu publicar algo novo.
+* <a href="https://github.com/tiangolo" class="external-link" target="_blank">Me seguir no **GitHub**</a>.
+    * Ver outros projetos Open Source que criei e que podem ajudar você.
+    * Me seguir para saber quando eu criar um novo projeto Open Source.
+* <a href="https://x.com/tiangolo" class="external-link" target="_blank">Me seguir no **X (Twitter)**</a> ou no <a href="https://fosstodon.org/@tiangolo" class="external-link" target="_blank">Mastodon</a>.
+    * Me contar como você usa o FastAPI (adoro saber disso).
+    * Ficar sabendo quando eu fizer anúncios ou lançar novas ferramentas.
+    * Você também pode <a href="https://x.com/fastapi" class="external-link" target="_blank">seguir @fastapi no X (Twitter)</a> (uma conta separada).
+* <a href="https://www.linkedin.com/in/tiangolo/" class="external-link" target="_blank">Me seguir no **LinkedIn**</a>.
+    * Ver quando eu fizer anúncios ou lançar novas ferramentas (embora eu use mais o X (Twitter) 🤷‍♂).
+* Ler o que escrevo (ou me seguir) no <a href="https://dev.to/tiangolo" class="external-link" target="_blank">**Dev.to**</a> ou no <a href="https://medium.com/@tiangolo" class="external-link" target="_blank">**Medium**</a>.
+    * Ler outras ideias, artigos e conhecer ferramentas que criei.
+    * Me seguir para ver quando eu publicar algo novo.
 
-## Tweete sobre **FastAPI**
+## Tweet sobre o **FastAPI** { #tweet-about-fastapi }
 
-<a href="https://x.com/compose/tweet?text=I'm loving @fastapi because... https://github.com/fastapi/fastapi" class="external-link" target="_blank">Tweete sobre o **FastAPI**</a> e compartilhe comigo e com os outros o porque de gostar do FastAPI. 🎉
+<a href="https://x.com/compose/tweet?text=I'm loving @fastapi because... https://github.com/fastapi/fastapi" class="external-link" target="_blank">Tweet sobre o **FastAPI**</a> e conte para mim e para outras pessoas por que você gosta dele. 🎉
 
-Adoro ouvir sobre como o **FastAPI** é usado, o que você gosta nele, em qual projeto/empresa está sendo usado, etc.
+Eu adoro saber como o **FastAPI** está sendo usado, o que você tem curtido nele, em qual projeto/empresa você o utiliza, etc.
 
-## Vote no FastAPI
+## Vote no FastAPI { #vote-for-fastapi }
 
 * <a href="https://www.slant.co/options/34241/~fastapi-review" class="external-link" target="_blank">Vote no **FastAPI** no Slant</a>.
-* <a href="https://alternativeto.net/software/fastapi/" class="external-link" target="_blank">Vote no **FastAPI** no AlternativeTo</a>.
+* <a href="https://alternativeto.net/software/fastapi/about/" class="external-link" target="_blank">Vote no **FastAPI** no AlternativeTo</a>.
+* <a href="https://stackshare.io/pypi-fastapi" class="external-link" target="_blank">Diga que você usa o **FastAPI** no StackShare</a>.
 
-## Responda perguntas no GitHub
+## Ajude outras pessoas com perguntas no GitHub { #help-others-with-questions-in-github }
 
-Você pode acompanhar as <a href="https://github.com/fastapi/fastapi/issues" class="external-link" target="_blank">perguntas existentes</a> e tentar ajudar outros,            . 🤓
+Você pode tentar ajudar outras pessoas com suas perguntas em:
 
-Ajudando a responder as questões de varias pessoas, você pode se tornar um [Expert em FastAPI](fastapi-people.md#especialistas){.internal-link target=_blank} oficial. 🎉
+* <a href="https://github.com/fastapi/fastapi/discussions/categories/questions?discussions_q=category%3AQuestions+is%3Aunanswered" class="external-link" target="_blank">GitHub Discussions</a>
+* <a href="https://github.com/fastapi/fastapi/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Aquestion+-label%3Aanswered+" class="external-link" target="_blank">GitHub Issues</a>
 
-## Acompanhe o repositório do GitHub
+Em muitos casos você já pode saber a resposta para aquelas perguntas. 🤓
 
-Você pode "acompanhar" (watch) o FastAPI no GitHub (clicando no "olho" no canto superior direito): <a href="https://github.com/fastapi/fastapi" class="external-link" target="_blank">https://github.com/fastapi/fastapi</a>. 👀
+Se você estiver ajudando muitas pessoas com suas perguntas, você se tornará um(a) [Especialista em FastAPI](fastapi-people.md#fastapi-experts){.internal-link target=_blank} oficial. 🎉
 
-Se você selecionar "Acompanhando" (Watching) em vez de "Apenas Lançamentos" (Releases only) você receberá notificações quando alguém tiver uma nova pergunta.
+Apenas lembre-se, o ponto mais importante é: tente ser gentil. As pessoas chegam com frustrações e, em muitos casos, não perguntam da melhor forma, mas tente ao máximo ser gentil. 🤗
 
-Assim podendo tentar ajudar a resolver essas questões.
+A ideia é que a comunidade do **FastAPI** seja gentil e acolhedora. Ao mesmo tempo, não aceite bullying ou comportamentos desrespeitosos com outras pessoas. Temos que cuidar uns dos outros.
 
-## Faça perguntas
+---
 
-É possível <a href="https://github.com/fastapi/fastapi/issues/new/choose" class="external-link" target="_blank">criar uma nova pergunta</a> no repositório do GitHub, por exemplo:
+Veja como ajudar outras pessoas com perguntas (em discussions ou issues):
 
-* Faça uma **pergunta** ou pergunte sobre um **problema**.
-* Sugira novos **recursos**.
+### Entenda a pergunta { #understand-the-question }
 
-**Nota**: Se você fizer uma pergunta, então eu gostaria de pedir que você também ajude os outros com suas respectivas perguntas. 😉
+* Verifique se você consegue entender qual é o **objetivo** e o caso de uso de quem está perguntando.
 
-## Crie um Pull Request
+* Depois verifique se a pergunta (a grande maioria são perguntas) está **clara**.
 
-É possível [contribuir](contributing.md){.internal-link target=_blank} no código fonte fazendo Pull Requests, por exemplo:
+* Em muitos casos a pergunta feita é sobre uma solução imaginada pela pessoa usuária, mas pode haver uma solução **melhor**. Se você entender melhor o problema e o caso de uso, pode sugerir uma **solução alternativa** melhor.
 
-* Para corrigir um erro de digitação que você encontrou na documentação.
-* Para compartilhar um artigo, video, ou podcast criados por você sobre o FastAPI <a href="https://github.com/fastapi/fastapi/edit/master/docs/en/data/external_links.yml" class="external-link" target="_blank">editando este arquivo</a>.
-    * Não se esqueça de adicionar o link no começo da seção correspondente.
-* Para ajudar [traduzir a documentação](contributing.md#traducoes){.internal-link target=_blank} para sua lingua.
-    * Também é possivel revisar as traduções já existentes.
-* Para propor novas seções na documentação.
-* Para corrigir um bug/questão.
-* Para adicionar um novo recurso.
+* Se você não entender a pergunta, peça mais **detalhes**.
 
-## Entre no chat
+### Reproduza o problema { #reproduce-the-problem }
 
-Entre no 👥 <a href="https://discord.gg/VQjSZaeJmf" class="external-link" target="_blank">server de conversa do Discord</a> 👥 e conheça novas pessoas da comunidade
-do FastAPI.
+Na maioria dos casos e na maioria das perguntas há algo relacionado ao **código original** da pessoa.
 
-/// tip | Dica
+Em muitos casos ela só copia um fragmento do código, mas isso não é suficiente para **reproduzir o problema**.
+
+* Você pode pedir que forneçam um <a href="https://stackoverflow.com/help/minimal-reproducible-example" class="external-link" target="_blank">exemplo mínimo, reproduzível</a>, que você possa **copiar e colar** e executar localmente para ver o mesmo erro ou comportamento que elas estão vendo, ou para entender melhor o caso de uso.
+
+* Se você estiver muito generoso(a), pode tentar **criar um exemplo** assim você mesmo(a), apenas com base na descrição do problema. Só tenha em mente que isso pode levar bastante tempo e pode ser melhor pedir primeiro que esclareçam o problema.
+
+### Sugira soluções { #suggest-solutions }
+
+* Depois de conseguir entender a pergunta, você pode dar uma possível **resposta**.
+
+* Em muitos casos, é melhor entender o **problema subjacente ou caso de uso**, pois pode haver uma forma melhor de resolver do que aquilo que estão tentando fazer.
+
+### Peça para encerrar { #ask-to-close }
+
+Se a pessoa responder, há uma grande chance de você ter resolvido o problema, parabéns, **você é um(a) herói(na)**! 🦸
+
+* Agora, se isso resolveu o problema, você pode pedir para:
+
+    * No GitHub Discussions: marcar o comentário como a **resposta**.
+    * No GitHub Issues: **encerrar** a issue.
+
+## Acompanhe o repositório do GitHub { #watch-the-github-repository }
+
+Você pode “acompanhar” (watch) o FastAPI no GitHub (clicando no botão “watch” no canto superior direito): <a href="https://github.com/fastapi/fastapi" class="external-link" target="_blank">https://github.com/fastapi/fastapi</a>. 👀
+
+Se você selecionar “Acompanhando” (Watching) em vez de “Apenas lançamentos” (Releases only), receberá notificações quando alguém criar uma nova issue ou pergunta. Você também pode especificar que quer ser notificado(a) apenas sobre novas issues, ou discussions, ou PRs, etc.
+
+Assim você pode tentar ajudar a resolver essas questões.
+
+## Faça perguntas { #ask-questions }
+
+Você pode <a href="https://github.com/fastapi/fastapi/discussions/new?category=questions" class="external-link" target="_blank">criar uma nova pergunta</a> no repositório do GitHub, por exemplo para:
+
+* Fazer uma **pergunta** ou perguntar sobre um **problema**.
+* Sugerir uma nova **funcionalidade**.
+
+**Nota**: se você fizer isso, então vou pedir que você também ajude outras pessoas. 😉
+
+## Revise Pull Requests { #review-pull-requests }
+
+Você pode me ajudar revisando pull requests de outras pessoas.
+
+Novamente, por favor tente ao máximo ser gentil. 🤗
+
+---
+
+Veja o que ter em mente e como revisar um pull request:
+
+### Entenda o problema { #understand-the-problem }
+
+* Primeiro, garanta que você **entendeu o problema** que o pull request tenta resolver. Pode haver uma discussão mais longa em uma Discussion ou issue do GitHub.
+
+* Também há uma boa chance de o pull request não ser realmente necessário porque o problema pode ser resolvido de uma **forma diferente**. Aí você pode sugerir ou perguntar sobre isso.
 
-Para perguntas, pergunte nas <a href="https://github.com/fastapi/fastapi/issues/new/choose" class="external-link" target="_blank">questões do GitHub</a>, lá tem um chance maior de você ser ajudado sobre o FastAPI [FastAPI Experts](fastapi-people.md#especialistas){.internal-link target=_blank}.
+### Não se preocupe com estilo { #dont-worry-about-style }
 
-Use o chat apenas para outro tipo de assunto.
+* Não se preocupe muito com coisas como estilos de mensagens de commit, eu vou fazer squash e merge personalizando o commit manualmente.
+
+* Também não se preocupe com regras de estilo, já há ferramentas automatizadas verificando isso.
+
+E se houver qualquer outra necessidade de estilo ou consistência, vou pedir diretamente, ou vou adicionar commits por cima com as mudanças necessárias.
+
+### Verifique o código { #check-the-code }
+
+* Verifique e leia o código, veja se faz sentido, **execute localmente** e veja se realmente resolve o problema.
+
+* Depois **comente** dizendo que você fez isso, é assim que saberei que você realmente verificou.
+
+/// info | Informação
+
+Infelizmente, eu não posso simplesmente confiar em PRs que têm várias aprovações.
+
+Já aconteceu várias vezes de haver PRs com 3, 5 ou mais aprovações, provavelmente porque a descrição é atraente, mas quando eu verifico os PRs, eles estão quebrados, têm um bug, ou não resolvem o problema que afirmam resolver. 😅
+
+Por isso, é realmente importante que você leia e execute o código, e me avise nos comentários que você fez isso. 🤓
 
 ///
 
-### Não faça perguntas no chat
+* Se o PR puder ser simplificado de alguma forma, você pode pedir isso, mas não há necessidade de ser exigente demais, pode haver muitos pontos de vista subjetivos (e eu terei o meu também 🙈), então é melhor focar nas coisas fundamentais.
+
+### Testes { #tests }
+
+* Me ajude a verificar se o PR tem **testes**.
+
+* Verifique se os testes **falham** antes do PR. 🚨
 
-Tenha em mente que os chats permitem uma "conversa mais livre", dessa forma é muito fácil fazer perguntas que são muito genéricas e dificeís de responder, assim você pode acabar não sendo respondido.
+* Depois verifique se os testes **passam** após o PR. ✅
 
-Nas questões do GitHub o template irá te guiar para que você faça a sua pergunta de um jeito mais correto, fazendo com que você receba respostas mais completas, e até mesmo que você mesmo resolva o problema antes de perguntar. E no GitHub eu garanto que sempre irei responder todas as perguntas, mesmo que leve um tempo. Eu pessoalmente não consigo fazer isso via chat. 😅
+* Muitos PRs não têm testes, você pode **lembrar** a pessoa de adicionar testes, ou até **sugerir** alguns testes você mesmo(a). Essa é uma das coisas que consomem mais tempo e você pode ajudar muito com isso.
 
-Conversas no chat não são tão fáceis de serem encontrados quanto no GitHub, então questões e respostas podem se perder dentro da conversa. E apenas as que estão nas questões do GitHub contam para você se tornar um [Expert em FastAPI](fastapi-people.md#especialistas){.internal-link target=_blank}, então você receberá mais atenção nas questões do GitHub.
+* Depois também comente o que você testou, assim vou saber que você verificou. 🤓
 
-Por outro lado, existem milhares de usuários no chat, então tem uma grande chance de você encontrar alguém para trocar uma idéia por lá em qualquer horário. 😄
+## Crie um Pull Request { #create-a-pull-request }
+
+Você pode [contribuir](contributing.md){.internal-link target=_blank} com o código-fonte fazendo Pull Requests, por exemplo:
+
+* Para corrigir um erro de digitação que você encontrou na documentação.
+* Para compartilhar um artigo, vídeo ou podcast que você criou ou encontrou sobre o FastAPI, <a href="https://github.com/fastapi/fastapi/edit/master/docs/en/data/external_links.yml" class="external-link" target="_blank">editando este arquivo</a>.
+    * Garanta que você adicione seu link no início da seção correspondente.
+* Para ajudar a [traduzir a documentação](contributing.md#translations){.internal-link target=_blank} para seu idioma.
+    * Você também pode ajudar a revisar as traduções criadas por outras pessoas.
+* Para propor novas seções de documentação.
+* Para corrigir uma issue/bug existente.
+    * Garanta que você adicione testes.
+* Para adicionar uma nova funcionalidade.
+    * Garanta que você adicione testes.
+    * Garanta que você adicione documentação se for relevante.
 
-## Patrocine o autor
+## Ajude a manter o FastAPI { #help-maintain-fastapi }
+
+Ajude-me a manter o **FastAPI**! 🤓
+
+Há muito trabalho a fazer e, para a maior parte dele, **VOCÊ** pode ajudar.
+
+As principais tarefas que você pode fazer agora são:
+
+* [Ajudar outras pessoas com perguntas no GitHub](#help-others-with-questions-in-github){.internal-link target=_blank} (veja a seção acima).
+* [Revisar Pull Requests](#review-pull-requests){.internal-link target=_blank} (veja a seção acima).
+
+Essas duas tarefas são as que **mais consomem tempo**. Esse é o principal trabalho de manter o FastAPI.
+
+Se você puder me ajudar com isso, **você está me ajudando a manter o FastAPI** e garantindo que ele continue **avançando mais rápido e melhor**. 🚀
+
+## Entre no chat { #join-the-chat }
+
+Entre no 👥 <a href="https://discord.gg/VQjSZaeJmf" class="external-link" target="_blank">servidor de chat do Discord</a> 👥 e converse com outras pessoas da comunidade FastAPI.
+
+/// tip | Dica
+
+Para perguntas, faça-as no <a href="https://github.com/fastapi/fastapi/discussions/new?category=questions" class="external-link" target="_blank">GitHub Discussions</a>, há uma chance muito maior de você receber ajuda pelos [Especialistas em FastAPI](fastapi-people.md#fastapi-experts){.internal-link target=_blank}.
+
+Use o chat apenas para outras conversas gerais.
+
+///
 
-Você também pode ajudar o autor financeiramente (eu) através do <a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">GitHub sponsors</a>.
+### Não use o chat para perguntas { #dont-use-the-chat-for-questions }
 
-Lá você pode me pagar um cafézinho ☕️ como agradecimento. 😄
+Tenha em mente que, como os chats permitem uma “conversa mais livre”, é fácil fazer perguntas muito gerais e mais difíceis de responder, então você pode acabar não recebendo respostas.
 
-E você também pode se tornar um patrocinador Prata ou Ouro do FastAPI. 🏅🎉
+No GitHub, o template vai orientar você a escrever a pergunta certa para que você consiga obter uma boa resposta com mais facilidade, ou até resolver o problema sozinho(a) antes de perguntar. E no GitHub eu consigo garantir que sempre vou responder tudo, mesmo que leve algum tempo. Eu pessoalmente não consigo fazer isso com os sistemas de chat. 😅
 
-## Patrocine as ferramente que potencializam o FastAPI
+As conversas nos sistemas de chat também não são tão fáceis de pesquisar quanto no GitHub, então perguntas e respostas podem se perder na conversa. E somente as que estão no GitHub contam para você se tornar um(a) [Especialista em FastAPI](fastapi-people.md#fastapi-experts){.internal-link target=_blank}, então é bem provável que você receba mais atenção no GitHub.
 
-Como você viu na documentação, o FastAPI se apoia em nos gigantes, Starlette e Pydantic.
+Por outro lado, há milhares de usuários nos sistemas de chat, então há uma grande chance de você encontrar alguém para conversar por lá quase o tempo todo. 😄
 
-Patrocine também:
+## Patrocine o autor { #sponsor-the-author }
 
-* <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>
+Se o seu **produto/empresa** depende de ou está relacionado ao **FastAPI** e você quer alcançar suas pessoas usuárias, você pode patrocinar o autor (eu) através do <a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">GitHub sponsors</a>. Dependendo do nível, você pode obter benefícios extras, como um selo na documentação. 🎁
 
 ---
 
-Muito Obrigado! 🚀
+Obrigado! 🚀