CONTRIBUTING.md

Para contribuir com informações de alunos siga os passos abaixo:

1. Crie uma issue

No topo da página principal do repositório clique no botão issues

Depois clique no botão verde New Issue

Digite um título e uma descrição informando sobre qual contribuição você irá fazer. Por exemplo.

Título: Informações do aluno Valdemir Filho
Descrição: Vou adicionar as informações para networking do aluno Valdemir Filho

Clique no botão verde Submit new issue

2. Crie uma cópia desse repositório em sua conta do github. Esse processo chamamos de fork.

Faça um fork do repositório clicando no botão no canto superio direito da página.

Ou através do link https://github.com/valdemirfilho/devexplorer/fork

Caso tenha dificuldade em fazer o fork do Projeto veja o passo a passo na documentação do github.

3. Clone o repositório.

Com o fork do repositório realizado, você está pronto para cloná-lo para que você tenha uma cópia de trabalho local do código. Abra um terminal e clone o repositório que está em sua conta para a sua máquina local. Vamos utilizar o comando git clone juntamente com a URL que aponta para o seu fork do repositório. Esta URL será semelhante à URL abaixo.

git clone https://github.com/[seu-nome-de-usuário]/devexplorer.git

Você pode copiar a URL usando o botão verde [Code] da página do seu repositório que você acabou de fazer fork.

4. Entre no diretório do projeto.

Digite no terminal o código abaixo.

cd devexplorer

5. Crie uma Nova Branch.

Crie uma branch com o nome do seu usuário do github.

Você pode verificar o nome do seu usuário na URL do ser perfil do github:
https://github.com/[seu-nome-de-usuário]

Agora, vamos criar nossa nova branch com o comando git branch

git branch seu-nome-de-usuário

Agora que nossa nova branch está criada, podemos mudar para nos certificar de que estamos trabalhando nessa branch usando o comando git checkout

git checkout seu-nome-de-usuário

Sempre que você trabalha em um projeto colaborativo, você e outros programadores que contribuem para o repositório terão ideias diferentes para novos recursos ou correções de uma só vez. Alguns desses novos recursos não levarão tempo significativo para serem implementados, mas alguns deles estarão em andamento. Por isso, é importante ramificar o repositório para que você possa gerenciar o fluxo de trabalho, isolar seu código e controlar quais recursos serão retornados à branch principal do repositório do projeto.

Alternativamente, você pode combinar os dois comandos acima, criando e mudando para a nova branch, com o seguinte comando: git checkout -b seu-nome-de-usuário

6. Faça Alterações Localmente

Neste ponto você pode modificar arquivos existentes ou adicionar novos arquivos ao projeto em sua própria branch. Abra o diretório do projeto no seu editor de código preferido. Ex: vscode. Você pode digitar no terminal

code .

Vá até o diretório users.example. Copie o arquivo users.js.example para dentro do diretório users que está dentro do diretório app. Agora renomeie o arquivo users.js.example para seu-nome-de-usuário.js. Por exemplo, meu nome de usuário do github é valdemirfilho logo o meu arquivo deve ser renomeado para valdemirfilho.js.

Após renomear, abra o arquivo e preencha com as suas informações. Preencha inicialmente suas informações para networking. As informações sobre os desafios são opcionais e podem ser preenchidas a medida que você for finalizando os desafios.

Depois de modificar o arquivo vamos prepará-lo para fazer o commit. Vamos adicionar todas as alterações que fizemos

git add -A

Em seguida, queremos registrar as alterações que fizemos no repositório com o comando git commit.

git commit -m "Adicionei as informações de [seu-nome-de-usuário]"

Nesse ponto você pode usar o comando git push para enviar as alterações locais para o seu repositório do github

Lembre-se que neste ponto a branch atual que você está trabalhando deve ter o seu nome de usuário do github.

git push -u origin [branch-atual]

7. Crie um Pull Request

Nesse ponto você poderá fazer um pull request para o repositório original. Você deve navegar até o seu repositório onde você fez o fork e pressionar o botão Compare & pull request

Na página de Open a pull request preencha o título e deixe um comentário começando com Fix # e seleciona a issue que você criou anteriormente.

Pronto! Você fez seu primeiro Pull Request! Agora é só aguardar o mantenedor do projeto avaliar a sua contribuição e fazer um merge do seu código com o código do projeto. 😁

Dúvidas?

Procurar Valdemir Filho no Discord do Explorer.

Eu e a comunidade agradecemos a sua ajuda 💜