diff --git a/docs/src/content/docs/pt-br/challenges/angular/1-projection.md b/docs/src/content/docs/pt-br/challenges/angular/1-projection.md index ff266e2..d507cc9 100644 --- a/docs/src/content/docs/pt-br/challenges/angular/1-projection.md +++ b/docs/src/content/docs/pt-br/challenges/angular/1-projection.md @@ -15,7 +15,7 @@ sidebar: ## Informação -Em Angular, projeção de conteúdo é uma técnica poderosa para criar componente altamente personalizados. Usar e entender os conceitos do ng-content e ngTemplateOutlet pode melhorar significativamente sua habilidade na criação de componentes compartilháveis. +Em Angular, projeção de conteúdo é uma técnica robusta para criar componente altamente personalizados. Usar e entender os conceitos do ng-content e ngTemplateOutlet pode melhorar significativamente sua habilidade na criação de componentes compartilháveis. Você pode aprender tudo sobre ng-content [aqui](https://angular.io/guide/content-projection#projecting-content-in-more-complex-environments), desde projeção simples até casos mais complexos. @@ -25,13 +25,13 @@ Com essas duas ferramentas em mãos, você está pronto para realizar o desafio. ## Declaração -Você começará com uma aplicação totalmente funcional que inclui um _dashboard_, que possui um cartão de professor e de estudante. O objetivo é implementar o cartão de cidade. +Você começará com uma aplicação totalmente funcional que inclui um dashboard, que possui um cartão de professor e de estudante. O objetivo é implementar o cartão de cidade. -Apesar da aplicação funcionar, a experiência do desenvolvedor (DX) está longe de estar otimizada. Toda vez que você precisar implementar um novo cartão, você terá que modificar o `card.component.ts`. Em projetos reais, esse componente pode ser compartilhado entre várias aplicações. O objetivo do desafio é criar um `CardComponent` que possa ser personalizado sem nenhuma modificação. Uma vez criado o componente, você pode começar a implementar o `CityCardComponent` e assegurar que não mexerá no `CardComponent`. +Apesar da aplicação funcionar, a experiência do desenvolvedor (DX) está nem um pouco otimizada. Toda vez que você precisar implementar um novo cartão, você terá que modificar o `card.component.ts`. Em projetos reais, esse componente pode ser compartilhado entre várias aplicações. O objetivo do desafio é criar um `CardComponent` que possa ser personalizado sem nenhuma modificação. Uma vez criado o componente, você pode começar a implementar o `CityCardComponent` e assegurar que não mexerá no `CardComponent`. ## Restrições - Você deve refatorar o `CardComponent` e `ListItemComponent`. -- A diretiva `NgFor` deve ser declarada e permanecer dentro do `CardComponent`. Você pode ficar instigado em querer movê-la para o `ParentCardComponent` como `TeacherCardComponent`. +- A diretiva `NgFor` deve ser declarada e permanecer dentro do `CardComponent`. Você pode ficar instigado em querer mover ela para o `ParentCardComponent` como `TeacherCardComponent`. - `CardComponent` não deve conter nenhum `NgIf` ou `NgSwitch`. -- CSS: tente evitar usar `::ng-deep` (motivo [aqui](https://angular.io/guide/component-styles#deprecated-deep--and-ng-deep)). Ache uma maneira melhor para lidar com o CSS. +- CSS: tente evitar usar `::ng-deep`. Ache uma maneira melhor para lidar com o CSS. diff --git a/docs/src/content/docs/pt-br/guides/checkout-answer.md b/docs/src/content/docs/pt-br/guides/checkout-answer.md index ae8ff9b..425c408 100644 --- a/docs/src/content/docs/pt-br/guides/checkout-answer.md +++ b/docs/src/content/docs/pt-br/guides/checkout-answer.md @@ -1,25 +1,25 @@ --- -title: Verificar resposta dos outros +title: Verifique a resposta dos outros description: Guia para verificar a resposta de outra pessoa sidebar: order: 3 --- -Todas as respostas dos Desafios Angular são apresentadas na forma de _Pull Request_ (PR). Para ver e segui-las, navegue pela página **Files Changes** no GitHub. Entretanto, entender e seguir esse processo pode não ser direto se você não estiver familiarizado com a interface. Assim, você pode preferir verificar a _branch_ e revisar a solução na sua IDE de preferência. +Todas as respostas do Desafios Angular são apresentadas na forma de Pull Request (PR). Para ver e seguir elas, navegue pela página **Files Changes** no GitHub. Entretanto, entender e seguir esse processo pode não ser direto se você não estiver familiarizado com a interface. Muitas vezes, você pode preferir verificar a branch e revisar a solução na sua IDE de preferência. -Este guia foi criado para ajudar você a conseguir ver as respostas que desejar. +Este guia foi criado para ajudar você a conseguir isso. ## Confire PR de outra pessoa localmente ### Sincronize seu repositório -Primeiro, você precisa sincronizar seu _fork_ para garantir que ele está atualizado com o repositório bifurcado. +Primeiro, você precisa sincronizar seu fork para garantir que ele está atualizado com o repositório bifurcado. -Isso pode ser feito clicando no botão **Sync fork** na página principal de seu _fork_. +Isso pode ser feito clicando no botão Sync fork na página principal de seu fork. ![Sync project header](../../../../assets/fork-sync.png) -A imagem acima mostra que minha _branch_ está atrás da _branch_ principal por 8 _commits_, e será necessário sincronizá-la para ficar atualizada. +A imagem acima mostra que minha branch está atrás da branch principal por 8 commits, e será necessário sincronizá-la para deixar ela atualizada. ![Sync project update modal](../../../../assets/sync-fork-update.png) @@ -29,7 +29,7 @@ Vá até o PR que desejar conferir localmente e pegue seu ID. Você o achará no ![PR header](../../../../assets/PR-header.png) -Depois, abra um terminal, vá até o diretório de seu projeto e execute o seguinte comando: +Depois, abra um terminal dentro do diretório de seu projeto e execute o seguinte comando: ```bash gh pr checkout @@ -40,7 +40,7 @@ Se você não lembrar o comando, clique no butão Fork no cabeçalho. Isso criará uma cópia do repositório no seu GitHub pessoal. ## Clone o repositório para sua máquina local Escolha um diretório/pasta no seu computador e clone o repositório. -Abra o terminal, navegue até a pasta selecionada e digite o comando: +Abra um terminal, navegue até a pasta selecionada e digite o comando: ```bash git clone https://github.com/[SEU_NOME_GITHUB]/angular-challenges.git @@ -35,7 +35,7 @@ Você pode achar a URL para clonar clicando no botão Sync fork na página principal de seu _fork_. +Você pode fazer isso clicando no botão Sync fork na página principal de seu fork. ![Sync project header](../../../../assets/fork-sync.png) -A imagem acima mostra que minha _branch_ está atrás da _branch_ principal por 8 _commits_ e eu preciso sincronizar para atualizá-la com as mudanças mais recentes. +A imagem acima mostra que minha branch está atrás da branch principal por 8 commits e eu preciso sincronizar para atualizar ela com as mudanças mais recentes. ![Sync project update modal](../../../../assets/sync-fork-update.png) ### Abra um terminal -Abra um terminal de sua escolha, pode ser tanto na sua IDE de escolha ou uma instância independente. +Abra um terminal de sua escolha, pode ser tanto na sua IDE favorita ou uma instância independente. ### Git -Siga os seguintes commandos para realizar um _rebase_ na sua _branch_ local: +Siga os seguintes comandos para realizar um rebase na sua branch local: -```bash -git checkout main -git pull -git checkout [sua branch] -git rebase main -# Por fim, resolva os conflitos -``` +- git checkout main +- git pull +- git checkout [sua branch] +- git rebase main +- Resolva Conflitos -Neste passo, o _rebase_ pode parar, porque sua _branch_ local tem arquivos conflitantes com a _branch_ principal. Corrija-os e depois disso feito: +Neste passo, o rebase pode parar, porque sua branch local tem arquivos conflitantes com a branch principal. Corrija-os e depois disso feito: -```bash -git add . -git rebase --continue -``` +- git add . +- git rebase --continue -Se sua _branch_ não tem nenhum conflito, uma mensagem de sucesso será mostrada. +Se sua branch não tem nenhum conflito, uma mensagem de sucesso será mostrada. -### _Push_ seu trabalho para a _branch_ remota +### Faça um Push do seu trabalho para a branch remota -Finalmente, faça um _push_ do seu trabalho de volta para o GitHub: +Por último, faça um push do seu trabalho de volta para o GitHub: -```bash -git push -f -``` +- git push -f diff --git a/docs/src/content/docs/pt-br/guides/resolve-challenge.md b/docs/src/content/docs/pt-br/guides/resolve-challenge.md index 01ebdca..27e2393 100644 --- a/docs/src/content/docs/pt-br/guides/resolve-challenge.md +++ b/docs/src/content/docs/pt-br/guides/resolve-challenge.md @@ -1,22 +1,22 @@ --- -title: Resolver um desafio +title: Resolva um desafio description: Guia de como resolver um desafio sidebar: order: 2 --- -Neste guia, você aprenderá em como resolver um desafio e submeter uma resposta para o repositório principal no GitHub. +Neste guia, você aprenderá como resolver um desafio e submeter uma resposta para o repositório principal no GitHub. ## Introdução -Este repositório é feito com [Nx](https://nx.dev/getting-started/intro). Nx é uma monorepositório que permite armazenar múltiplaa aplicações dentro de um mesmo espaço de trabalho. Cada desafio é uma aplicação separada. Se você abrir o diretório `apps`, achará várias pastas, sendo cada uma relacionada a um desafio específico. Cada diretório representar um aplicação `Nx` completa e independente. Para executar e começar uma aplicação, abra seu terminal e use: +Este repositório é feito com [Nx](https://nx.dev/getting-started/intro). Nx é um monorepositório que permite armazenar múltiplas aplicações dentro de um mesmo espaço de trabalho. Cada desafio é uma aplicação separada. Se você abrir o diretório `apps`, achará várias pastas, sendo cada uma relacionada a um desafio específico. Cada diretório representa um aplicação `Nx` completa e independente. Para executar e começar uma aplicação, abra seu terminal e use: ```bash npx nx serve ``` :::note[Nota] -Se você não tem certeza quanto ao `NOME_APLICACAO`, abra o arquivo README.md com o nome do desafio. O comando `serve` está escrito nele com um link para a documentação do desafio. +Se você não tem certeza quanto ao `NOME_APLICACAO`, abra o arquivo README.md do desafio. O comando `serve` está escrito nele com um link para a documentação do desafio. ::: :::note[Nota] @@ -32,7 +32,7 @@ npm i -g nx ## Crie uma branch Git -Antes de começar a implementação de sua solução para um desafio, crie uma _branch_ para commitar seu trabalho. +Antes de começar a implementação de sua solução para um desafio, crie uma branch para commitar seu trabalho. ```bash git checkout -b @@ -46,41 +46,41 @@ Siga as instruções para resolver o desafio. O último passo é commitar seu trabalho seguindo o [Conventional Guidelines](https://www.conventionalcommits.org/en/v1.0.0/). -Finalmente, faça um _push_ do trabalho ao repositório remoto com o seguinte comando: +Finalmente, faça um push do trabalho ao repositório remoto com o seguinte comando: ```bash git push --set-upstream origin ``` -:::tip[Não lembre disso] -Você não precisa lembrar do comando. Você pode simplemente lembrar do `git push` e se é a primeira vez que você efetua um _push_ na _branch_, `git` fornecerá para você o comando completo. +:::tip[Não precisa lembrar disso] +Você não precisa lembrar do comando. Você pode simplemente lembrar do `git push` e, se é a primeira vez que você faz um push na branch, `git` fornecerá para você o comando completo. ::: -## Submeta seu trabalho no Repositório Principal +## Submeta seu Trabalho no Repositório Principal Agora, todo seu trabalho está localizado dentro de sua instância local do repositório do Desafios Angular. -O próximo passo é ir para a [página principal do Desafios Angular](https://github.com/tomalaforge/angular-challenges) e criar um novo _Pull request_. +O próximo passo é ir para a [página principal do Desafios Angular](https://github.com/tomalaforge/angular-challenges) e criar um novo Pull Request. -GitHub deve mostrar um cabeçalho notificação para ajudar a criação do _pull request_. +GitHub deve mostrar no cabeçalho uma notificação para ajudar a criação do pull request. Se não mostrar, você pode ter feito um dos passos anteriores errado ou você pode ir para a aba Pull Request e clicar no botão New pull request. -Uma vez escolhidas as duas _branches_ para comparar, você deve ser redirecionado para a página: +Uma vez escolhidas as duas branches para comparar, você deve ser redirecionado para a seguinte página: ![New pull request screen](../../../../assets/new-pull-request.png) Na seção do título, comece com Answer: seguido pelo número do desafio. Depois, você está livre para adicionar o que você desejar. -:::danger[Perigo] +:::danger[Importante] Isso é muito importante. Isso deixará as outras pessoas saberem qual desafio você tentou resolver. ::: Na seção de descrição, você pode adicionar perguntas, problemas que encontrou ou qualquer coisa que queira compartilhar. Você pode deixar vazio caso não tenha nada para dizer. -Você pode clicar em Create pull request. +Agora você pode clicar em Create pull request. -Eu lerei e comentarei quando eu tiver algum tempo livre. +Eu o lerei e comentarei quando tiver algum tempo livre.

Não se preocupe se sua resposta não for revisada imediatamente. Estou fazendo isso de graça e durante meu tempo livre. Se você quiser me ajudar, você pode fazê-lo me patrocinando no github. Isso mostrará que meu trabalho é de grande ajuda para você e seu time.

@@ -89,5 +89,5 @@ Todo mundo é bem-vindo para comentar e ver outros PRs. ::: :::tip[Campeão OSS] -🔥 Ao terminar este tutorial, você está pronto para contribuir para qualquer outro repositório público do GitHub e submeter um PR. É tão simples quanto isso. 🔥 +🔥 Ao terminar este tutorial, você está pronto para contribuir em qualquer outro repositório público do GitHub e submeter um PR. Simples assim. 🔥 ::: diff --git a/docs/src/content/docs/pt-br/index.mdx b/docs/src/content/docs/pt-br/index.mdx index 384cc9f..44383e7 100644 --- a/docs/src/content/docs/pt-br/index.mdx +++ b/docs/src/content/docs/pt-br/index.mdx @@ -4,9 +4,9 @@ description: Comece resolvendo esses desafios e se torne um melhor desenvolvedor template: splash noCommentSection: true banner: - content: Eu terei menos tempo livre nos próximos dois meses, então não se preocupe se seus pull requests levarem um tempo para serem revisados. + content: Terei menos tempo livre nos próximos dois meses, não se preocupe se seus pull requests levarem um tempo para serem revisados. hero: - tagline: Comece agora e vire um expert em Angular! + tagline: Comece agora e vire um especialista em Angular! image: file: ../../../assets/angular-challenge.webp actions: @@ -27,25 +27,25 @@ import { Card, CardGrid } from '@astrojs/starlight/components'; import MyIcon from '../../../components/MyIcon.astro'; - - Este repositório possui 39 desafios relacionados a Angular, Nx, RxJS, + + Este repositório possui 40 desafios relacionados a Angular, Nx, RxJS, Ngrx e Typescript. Esses desafios são voltados para problemas reais ou funcionalidades específicas afim de melhorar suas habilidades. - Um dos objetivos desse repositório é baixar a barreira de entrada para o Software de + Um dos objetivos desse repositório é diminuir a barreira de entrada para o Software de Código Aberto (OSS). Ao realizar esses desafios, você aprenderá como começar a contruibuir em qualquer outro Projeto de Código Aberto. - Aprender e praticar um novo framework é sempre desafiador. O conjunto de desafios + Aprender e praticar um novo framework é sempre desafiador. Este conjunto de desafios possui casos de uso reais para aplicarmos o que aprendemos. Qualquer um pode comentar e oferecer assistência. - Aprender sozinho é legal, mas aprender juntos com outras pessoas levará você mais longe. + Aprender sozinho é legal, mas aprender junto com outras pessoas levará você mais longe. @@ -55,13 +55,13 @@ import MyIcon from '../../../components/MyIcon.astro'; - Completar esses desafios vai preparar você para qualquer desafio técnico que encontrar em - uma entrevista a uma vaga frontend. + Completar esses desafios vai preparar você para quaisquer desafios técnicos que encontrar em + uma entrevista para uma vaga frontend. Este projeto é livre e tem o objetivo de permanecer assim o máximo possível. No entanto, - tudo é feito durante meu tempo livre, incluindo a criação de desafios e revisão de pull requests (PRs). + tudo é feito durante meu tempo livre, incluindo a criação de desafios e revisão de pull requests (PRs). Patrocinar pode me ajudar e contribuir para o crescimento do projeto.