From 4ce6f991aaf5843df1e07255cc82900638231a57 Mon Sep 17 00:00:00 2001 From: Bernardo Bugmann Date: Thu, 30 Nov 2023 21:20:37 -0300 Subject: [PATCH] Update first chapter PT translation. (#744) * Update first chapter. * code review fixes --- _chapters/pt/who-is-this-guide-for.md | 24 ++++++++++++++++++++++-- 1 file changed, 22 insertions(+), 2 deletions(-) diff --git a/_chapters/pt/who-is-this-guide-for.md b/_chapters/pt/who-is-this-guide-for.md index f4425e495..80435657c 100644 --- a/_chapters/pt/who-is-this-guide-for.md +++ b/_chapters/pt/who-is-this-guide-for.md @@ -12,6 +12,26 @@ Esse guia foi feito para desenvolvedores full-stack ou desenvolvedores que desej Talvez você seja um desenvolvedor backend querendo aprender mais sobre a parte frontend de aplicações Serverless, ou um desenvolvedor frontend que gostaria de aprender mais sobre backend. Esse guia servirá para ambos os casos. -Por hora, apenas vamos abordar o desenvolvimento com JavaScript. Futuramente talvez abordemos outras linguagens e ambientes. Porém, para começar, nós achamos muito benéfico para um desenvolvedor full-stack utilizar apenas uma linguagem (JavaScript) e ambiente (NodeJs) para a construção de uma aplicação completa. +Pessoalmente, a ideia do Serverless foi uma enorme revelação para nós e isso nos fez criar um guia com qual poderíamos compartilhar o que aprendemos. Você pode saber mais sobre nós [**aqui**]({% link about/index.html %}). E [veja alguns exemplos de pessoas que construíram aplicações com SST clicando aqui]({% link showcase.md %}) -Pessoalmente, a ideia do Serverless foi uma enorme revelação para nós e isso nos fez criar um guia com qual poderíamos compartilhar o que aprendemos. Você pode saber mais sobre nós [**aqui**]({% link about/index.html %}). E [veja alguns exemplos de pessoas que construiram aplicações com a stack Serverless]({% link showcase.md %}) +Por hora, apenas vamos abordar o desenvolvimento com JavaScript/TypeScript. Futuramente talvez abordemos outras linguagens e ambientes. Porém, para começar, nós achamos muito benéfico para um desenvolvedor full-stack utilizar apenas uma linguagem (TypeScript) e ambiente (Node.js) para a construção de uma aplicação completa. + +### Por que TypeScript + +Nós usamos TypeScript desde o frontend, backend e até a criação da nossa infraestrutura. Se você não estiver familiar com TypeScript talvez você esteja pensando por que tipagem estática importa. + +Uma grande vantagem em usar tipagem estática em todo o código é que seu editor de código consegue autocompletar e mostrar opções inválidas no seu código. Isso é muito útil quando você esta começando. Porém, isso também pode ser útil quando você está configurando sua infraestrutura através de código. + +Deixando toda essa benevolência do autocomplete de lado, tipagem estática acaba sendo um ponto crítico para ajudar na manutenibilidade de um projeto. Isso importa muito se você pretende trabalhar no mesmo projeto, com o mesmo código, por anos. + +Deve ser fácil para você e seu time fazer modificações em partes do seu projeto após muito tempo sem mexer nele. TypeScript permite que você faça isso! Seu projeto não vai ser mais tão _frágil_ e você não terá medo de fazer modificações. + +#### TypeScript do jeito fácil + +Se você não está acostumado com TypeScript, você deve estar pensando _"Então eu vou ter que escrever todos esses tipos extras para minhas coisas?"_ ou _"Toda essa tipagem não vai deixar meu código verboso e assustador?"_. + +Essas preocupações são válidas. Mas acontece que, se as bibliotecas que você está usando são feitas para o uso junto ao TypeScript, você não irá ter tantas tipagens extras no seu código. Na verdade, como você vai ver nesse tutorial, você vai ter todos os benefícios de um projeto tipado com um código que quase parece com o JavaScript normal. + +Além disso, o TypeScript pode ser adotado gradativamente. Isso significa que você pode usar o nosso projeto base de TypeScript e adicionar JavaScript a ele. Fazer isso não é recomendável, porém isso pode ser uma opção. + +Vamos começar dando uma olhada sobre o que vamos contemplar nesse guia a seguir. \ No newline at end of file