Para ter sucesso na sua contribuição siga o nosso passo a passo que vai desde a configuração inicial... a solicitação do último pull request 🏆
Garanta que já tem o VSCode e a lista abaixo devidamente instalada na sua máquina, uma ótima maneira de descobrir é digitando os comandos abaixo no seu terminal:
node -v
git --version
yarn -vCaso você não tenha algumas das ferramentas acima instaladas acesse os links abaixo para baixá-las para sua máquina e faça a instalação.
-
✨ Você precisa fazer um fork desse repositório.
⚠️ Clicando emForkvocê irá criar uma cópia do repositório para sua conta noGithub
-
✨ Você precisa fazer um clone do seu repositório que foi forkado.
-
✨ Pelo seu terminal, vá até a área de trabalho e execute o comando abaixo, mas antes troque o texto
SEU_USERpelo seu usuário do Github ou você pode copiar aURLno local indicado na imagem anterior.git clone https://github.com/SEU_USER/rede-cidada-no-hacktoberfest2020.git cd rede-cidada-no-hacktoberfest2020 && yarn install && yarn start
-
✨ Se você não for direcionado automaticamente para a aplicação, vá no seu navegador web e acesse:
http://localhost:3000/
Ainda no terminal, tenha certeza que você está dentro da página do projeto que você acabou de clonar e execute code .
✨Você será direcionado para o Visual Studio Code e lá deve conter a estrutura abaixo:
✨Vá para src -> components -> Members -> data.js , esse será o arquivo que vamos utilizar para fazer nossas PRs.
✨Observe que o arquivo data.js tem um array members com apenas um objeto como exemplo, primeiramente você vai copiá-lo e colar essa cópia logo abaixo dele, depois apague todas as informações para deixá-lo no formato da imagem abaixo:
✨ Bora fazer adicionar alguma informação nesse novo objeto que você fez uma cópia, e depois já podemos enviar nossa primeira PR.
- No campo
nomevocê irá inserir o seu nome - No campo
participantevocê irá preencher com apenas uma das seguintes opções:- Aluno
- Professor
- Convidado
- No aquivo que você fez a alteração, aperte
Ctrl + spara salvar. - Vá para o terminal e dentro da pasta do projeto execute os comandos abaixo, atenção: execute um comando por vez:
git status git add . git commit -m "mensagem do commit com descrição"
- Agora que fizemos o commit precisamos verificar se existe algo novo no repositório original (O da Rede Cidadã que você fez o fork), execute os comandos abaixo no seu terminal:
git remote add upstream https://github.com/rede-cidada/rede-cidada-no-hacktoberfest2020.git git fetch upstream git pull upstream master
- Após executar o ``pull` pode acontecer de ter gerado conflitos, pelo fato de ter outras pessoas alterando o mesmo arquivo no mesmo ponto que você, se esse for o seu caso, será necessário resolver os conflitos primeiro antes de subir suas atualizações, iremos realizar este passo durante o evento, caso não tenha gerado conflitos você pode pular para o passo 9.
- Após resolver os conflitos você precisa commitar novamente suas alterações executando os mesmos comandos do passo 3 e 4
- Execute o comando abaixo para se certificar que você já tem todas as alterações do repositório original.
git pull upstream mastera partir desse momento vira um loop entre os passos 6, 7 e 8, até voc6e se certificar que seu repositório já tem todas as informações do repositório original... - Agora sim você pode mandar suas informações para seu repositório remoto executando o comando abaixo.
git push -u origin master
- Agora vá para o repositório no seu Github e clique em
Pull request
- Note que a comparação dos repositórios é feita da direita para esquerda e que a branch master do seu repositório está sendo comparada com a branch master do repositório da Rede Cidadã.
- ✨ Quando aparece o "Able to merge", significa que não há conflitos entre os repositórios, então você pode adicionar uma mensagem para o pull request e seguir para o passo 12.
⚠️ Caso apareça uma mensagem de conflito (ela estará em vermelho), volte para o vscode e repita os comandos a partir do passo 8.
- Clique em
Create pull requeste se tiver a mensagemThis branch has no conflicts with the base branch, significa que suapull requestfoi concluída com sucesso! ✅ PRONTO! Sua primeira pull request foi criada.
ATENÇÃO Aguarde sua primeira pull request ser aprovada para poder enviar a segunda.
- Volte para o vs code e preencha os campos abaixo do mesmo objeto que copiou na sua primeira
pull request- curso: seu curso no start, exemplo: Front-end, Java, Python...
- turno: o turno do seu curso: manhã, tarde ou noite
- professor: o nome do seu professor,
- Agora você precisa realizar o commit e solicitar a sua segunda
pull requestno github., para isso siga os passos 3 e 4 da1º Pull requestdepois pule para o passo 8.
ATENÇÃO Aguarde sua segunda pull request ser aprovada para poder enviar a terceira.
- Volte para o vs code e preencha os campos abaixo no objeto
fotodo mesmo objeto que copiou na sua primeirapull request.- src: coloque o link da foto do seu perfil do github
- alt: escreva uma pequena descrição da sua foto
- Agora você precisa realizar o commit e solicitar a sua terceira
pull requestno github., para isso siga os passos 3 e 4 da1º Pull requestdepois pule para o passo 8.
ATENÇÃO Aguarde sua terceira pull request ser aprovada para poder enviar a quarta.
- Volte para o vs code e preencha os campos abaixo no objeto
redesSociasdo mesmo objeto que copiou na sua primeirapull request.- github: coloque o link do seu github
- linkedin: coloque o link do seu linkedin
- Agora você precisa realizar o commit e solicitar a sua terceira
pull requestno github., para isso siga os passos 3 e 4 da1º Pull requestdepois pule para o passo 8.
🏆 Feito!! 💟 Você completou as 4 Pull Requests e agora pode ir na página do Hacktoberfest para conferir!