Skip to content

Fazendo um Pull Request do seu Fork

Adsu edited this page Oct 2, 2019 · 4 revisions

Pull request é uma maneira de você apresentar a nossa equipe as modificações que você fez e poder incluir elas na versão inicial se for aceita. Nesta parte mostraremos como fazer um pull request do seu fork ao Portugol Studio.

1 Certifique-se de que suas modificações estão no seu repositório

Entre no seu repositório no Github, veja se seus commits estão salvos e se há diferenças com o Portugol Oficial. Você verá como na seguinte imagem.

Ao clicar em commits você poderá ver todos os commits que você fez.

2 Criando um Pull Request

2.1 Alternativa 1

No seu repositório clique em Pull Requests

Nesta área estarão localizados todos os pull requests que você ou outras pessoas fizerem ao seu fork do Portugol. Para criar um pull request clique em New Pull Request.

2.2 Alternativa 2

Alternativamente, você pode criar um pull request direto da página inicial do seu repositório. Entre no seu repositório e se houver a barra como na imagem abaixo, clique em "Pull Request".

2.3 Selecionando os projetos

Certifique-se de que a comparação seja com "UNIVALI-LITE/Portugol-Studio" como na imagem abaixo. Se o base repository estiver errado, clique nele e altere para "UNIVALI-LITE/Portugol-Studio". Com o "base repository" e "head repository" corretos, clique em Create Pull Request.

2.4 Escrevendo o Pull Request

Deve haver duas áreas para a escrita. A primeira é o título do seu Pull Request, que será o título do seu commit no Potugol Studio, e a segunda comentários, que será para descrever sobre o seu Pull Request.

No título, caso o seu pull request não esteja completo e pronto, utilize a marcação [WIP] no inicio dele. Isso indicará que o trabalho ainda está em progresso.

Como não temos como adivinhar e analisar completamente o seu código será muito trabalhoso, é importante para nós que você escreva bem o que seu pull request fará e quais modificações terão nos comentários. Coloque o objetivo dele, o que isso irá ajudar o usuário e caso seja uma issue relatada coloque o link dela no junto no comentário.

Um modelo parecido com o seguinte é recomendado.

Quando terminar de descrever o seu Pull Request, pode clicar em Create Pull Request.

3 Confirmação

Se seu Pull request ocorreu normalmente você deve estar agora no repositório Oficial do Portugol Studio, você pode verificar isso olhando o caminho como na imagem abaixo. Ele deve estar como "UNIVALI-LITE/Portugol-Studio".

Verifique também se seus commits foram para o seu pull request, você pode verificar isso na área abaixo da sua descrição.

Caso esteja errado, houve algum problema na seleção de projetos no passo 2.3. Você pode fechar seu Pull Request como no passo 5, e criar um novo novamente.

Caso esteja tudo correto, então seu Pull Request está pronto.

4 O Processo

Quando você criar um Pull Request, dentro de algum tempo olharemos o seu request e o avaliaremos ( O tempo de espera até a avaliação varia de acordo com a disponibilidade pessoal de cada integrante do projeto). Durante o processo, caso achemos que deva haver melhorias antes de adicionar ao código oficial, faremos comentários sobre o que pode ser melhorado e que pediremos modifique seu código.

Não será necessário criar outro Pull Request, este que você criou capturará todos os seus commits que fizer no seu fork, portanto, se você fizer uma modificação a mais no seu fork esse mesmo pull request também receberá ela.

Quando as modificações forem atendidas, adicionaremos todas as suas modificações no Portugol Studio como um único commit e em seguida fecharemos. Caso queira adicionar novas modificações crie um novo Pull Request.

5 Fechando o Pull Request

Caso perceba que não quer adicionar suas modificações no Portugol-Studio ou houve erros na criação do Pull Request, você pode fechar o seu Pull Request. Vá até ao final da página onde estará um botão chamado Close Pull Request.

Ao clicar neste botão, seu Pull Request será fechado, entretanto ele não desaparecerá, apenas indicará que ele não deve ser adicionado ao código oficial.