Termos e acordos

Ao iniciar este projeto, você concorda com as diretrizes do Código de Ética e Conduta e do Manual da Pessoa Estudante da Trybe.

---

Boas vindas ao repositório do desafio da Aceleração Java!

Você já usa o GitHub diariamente para desenvolver os exercícios, certo? Agora, para desenvolver o desafio, você deverá seguir as instruções a seguir. Fique atento a cada passo, e se tiver qualquer dúvida, nos envie por Slack! #vqv 🚀

Aqui você vai encontrar os detalhes de como estruturar o desenvolvimento do seu desafio a partir deste repositório, utilizando uma branch específica e um Pull Request para colocar seus códigos.

---

Instruções para entregar seu projeto

Não se esqueça de consultar as documentações!

⚠️ Importante:

Esse projeto tem como intuito te treinar para ter mais familiaridade com a documentação de aplicações, por tanto, poderão haver alguns comandos ou atributos que não estão no curso, mas que devem ser descritos no decorrer dos requisitos.

Nesses casos, é importante se atentar a aquilo que o requisito pede, e lembrar sempre de utilizar a documentação oficial do Java para pesquisar detalhes sobre comandos.

Antes de começar a desenvolver

Lembre-se que você pode consultar nosso conteúdo sobre Git & GitHub sempre que precisar!

1. Clone o repositório

• Por exemplo: git clone [email protected]:tryber/desafio-aceleracao.git
• Entre no diretório do repositório que você acabou de clonar:
  • neste caso cd desafio-aceleracao

2. Instale as dependências:

   • mvn install

3. Crie uma branch a partir da branch main

• Verifique que você está na branch main
  • Exemplo: git branch
• Se não estiver, mude para a branch main
  • Exemplo: git checkout main
• Agora, crie uma branch onde você vai guardar os commits do seu desafio
  • Você deve criar uma branch no seguinte formato: nome-de-usuario-nome-do-desafio
  • Exemplo:
    • git checkout -b joaozinho-acc-java-sample

4. Adicione a sua branch com o novo commit ao repositório remoto

• Usando o exemplo anterior:
  • git push -u origin joaozinho-acc-java-sample

5. Crie um novo Pull Request (PR)

• Vá até a aba de Pull Requests deste repositório no GitHub
• Clique no botão verde "New pull request"
• Clique na caixa de seleção "Compare" e escolha a sua branch com atenção
• Clique no botão verde "Create pull request"
• Adicione uma descrição para o Pull Request e clique no botão verde "Create pull request"
• Não se preocupe em preencher mais nada por enquanto!
• Volte até a página de Pull Requests do repositório e confira que o seu Pull Request está criado

⚠️ Lembre-se do CheckStyle! Deixe seu Eclipse configurado para arrumar o estilo automaticamente. Qualquer dúvida, volte no conteúdo.

---

Durante o desenvolvimento

• ⚠ PULL REQUESTS COM ISSUES NO CHECKSTYLE NÃO SERÃO AVALIADAS, ATENTE-SE PARA RESOLVÊ-LAS ANTES DE FINALIZAR O DESENVOLVIMENTO! ⚠

• Faça commits das alterações que você fizer no código regularmente

• Lembre-se de sempre após um (ou alguns) commits atualizar o repositório remoto

• Os comandos que você utilizará com mais frequência são:

  1. git status (para verificar o que está em vermelho - fora do stage - e o que está em verde - no stage)
  2. git add (para adicionar arquivos ao stage do Git)
  3. git commit (para criar um commit com os arquivos que estão no stage do Git)
  4. git push -u origin nome-da-branch (para enviar o commit para o repositório remoto na primeira vez que fizer o push de uma nova branch)
  5. git push (para enviar o commit para o repositório remoto após o passo anterior)

---

Depois de terminar o desenvolvimento (opcional)

Para "entregar" seu projeto, siga os passos a seguir:

• Vá até a página DO SEU Pull Request, adicione a label de "code-review" e marque seus colegas
  • No menu à direita, clique no link "Labels" e escolha a label code-review
  • No menu à direita, clique no link "Assignees" e escolha o seu usuário
  • No menu à direita, clique no link "Reviewers" e digite students, selecione o time tryber/students-sd-0x

Se ainda houver alguma dúvida sobre como entregar seu projeto, aqui tem um video explicativo.

---

Requisitos do desafio

Calcular a média das notas de uma pessoa usuária

Escreva uma classe para conter seu método main que leia o nome de uma pessoa usuária do console Java e mais quatro valores que serão referentes às notas de 4 avaliações. Escreva uma segunda classe Java que calcule a média das 4 notas que a pessoa usuária entrou. Você deve chamar a classe de Nota. Essa classe deve conter um método chamado calcularMedia, que recebe 4 argumentos do tipo float ou double: nota1, nota2, nota3 e nota4. Esse método deve calcular e retornar a média, e esse retorno deve ser do tipo float ou double. Em outras palavras:

1. a pessoa deve entrar com seu nome e quatro valores decimais;
2. o método calcularMedia deve calcular e retornar a média dos valores inseridos pela pessoa usuária.

Lembre-se de que você deve fazer a conversão da entrada da pessoa usuária para float ou double para poder realizar o cálculo, pois o método scanner.next() lê a entrada da pessoa usuária e converte para String.

Exemplos

Exemplo 1

Supondo que minha entrada seja:

Qual é o seu nome?
Carla
Entre com as notas das provas:
Avaliação 1:
9.85
Avaliação 2:
9.58
Avaliação 3:
9.90
Avaliação 4:
8.75

Aqui nós lemos as entradas da pessoa usuária, fizemos as devidas conversões, instanciamos a classe Nota, passamos as notas das avaliações para o método calcularMedia(9.85, 9.58, 9.90, 8.75), e a saída da método calcularMedia(9.85, 9.58, 9.90, 8.75) deve ser 9.52. Ou seja, a saída final do programa deve ser similar a essa:

Qual é o seu nome?
Carla
Entre com as notas das provas:
Prova 1:
9.85
Prova 2:
9.58
Prova 3:
9.90
Prova 4:
8.75
Olá, Carla, sua média é 9.52

Exemplo 2

Nesse segundo exemplo, supondo que a entrada seja:

Qual é o seu nome?
Paulo
Entre com as notas das avaliações:
Avaliação 1:
7.80
Avaliação 2:
6.5
Avaliação 3:
10.00
Avaliação 4:
8.75

Aqui nós lemos as entradas da pessoa usuária, fizemos as devidas conversões, instanciamos a classe Nota, passamos as notas das provas para o método calcularMedia(7.80, 6.5, 10.00, 8.75), e a saída da método calcularMedia(7.80, 6.5, 10.00, 8.75) deve ser 8.2625. Ou seja, a saída final do programa deve ser similar a essa:

Qual é o seu nome?
Paulo
Entre com as notas das avaliações:
Avaliação 1:
7.80
Avaliação 2:
6.5
Avaliação 3:
10.00
Avaliação 4:
8.75
Olá, Paulo, sua média é 8.2625

---

Avisos Finais

Ao finalizar e submeter o desafio, não se esqueça de avaliar sua experiência preenchendo o formulário. Leva menos de 3 minutos!

Link: Formulário

O avaliador automático não necessariamente avalia seu projeto na ordem em que os requisitos aparecem no readme. Isso acontece para deixar o processo de avaliação mais rápido. Então, não se assuste se isso acontecer, ok?

---