1. Change a FastAPI to o FastAPI.
2. Change seu desenho to sua arquitetura seus padrões.

I don't think the second suggestion is necessary, since the official docs say "design".

What do you think @gustavoprezoto @SamuelBFavarin @EliasOlie ?

Perhaps it's a matter of dialect difference, but as a Northern Brazilian, the term desenho seems out of place in this context. To me, seu desenho suggests something more akin to the layout of the FastAPI GUI (hypothetically speaking), whereas sua arquitetura seus padrões conveys the idea of the documentation providing a comprehensive guide to the framework's best practices.

For reference:

• Software Architecture -> Arquitetura de Software
• Software Design (aka Design Patterns) -> Padrões de Software (vulgo Padrões de Projeto)
• (Difference between them)

@codespearhead, but the other meaning of desenho is projeto, even people that are not a native Portuguese-speaking but learned it know that.

The only place where I've seen desenho used as a synonym of projeto is when desenho is short for desenho arquitetônico, as in O arquiteto já finalizou o desenho / projeto do prédio (The architect has already finished the design of the building).

But let's see what the others have to say.

I would say seus padrões sounds more natural to me. We could even use design as it's also an official Portuguese term.

Check out the link:
https://michaelis.uol.com.br/busca?r=0&f=0&t=0&palavra=design

1. Change Ajuda to Ajude.
2. Change envolva-se to participe.

Change aprendermos FastAPI to aprendermos como usar o FastAPI.

I will do it, but there is a point about the usage of masculine defined article.

Assuming it's a question, I don't think I've ever seen it, or any other framework, being treated as a feminine noun on the Brazilian side of the internet.

@codespearhead, you assumed that this translation is just to serve Brazilian, but the name of its folder is not pt-br but pt.

The reason for having only one folder for each language, such as English, Spanish, French, and Portuguese, as opposed to one for each dialect, is simply because the current folders already contain a substantial amount of markup written in a specific dialect and the community tends to prioritize completeness over fragmentation, especially because consolidating efforts towards the same goal leads to better outcomes.

However, I hear your frustration and I completely understand where you're coming from. If you prefer, I can withdraw the review.

Change a FastAPI to o FastAPI.

FastAPI is an abstraction layer over the Python programming language to facilitate the development of Web APIs or Web applications.

The abstraction is translated to abstração, so from there comes the feminine defined article. But if framework would be the preferred word here, we'll fall in the same solution because framework is translated for many as estrutura, but abstração is more accurate since the framework itself offer something more than a simple structure.

@codespearhead.

In Brazilian Portuguese we don't have a word for framework in the context of Computer Science. If we need to describe it generically for someone that's not in the field we call it a ferramenta, but other than that it's always a masculine noun, as seen here and here.

Change Recursos adicionais, ligações externas to Material complementar, links externos.

@codespearhead, links is not Portuguese, do you not have any other solution?

I don't think we have a Brazilian Portuguese equivalent for link in this context. The most formal way to refer to it is by URLs externas, as can be seen in the Microsoft Docs.

I will apply all changes suggested as soon as possible.