Skip to content

Files

Latest commit

 

History

History
118 lines (62 loc) · 6.51 KB

github-desktop-tutorial.pt_br.md

File metadata and controls

118 lines (62 loc) · 6.51 KB

Open Source Love License: MIT Open Source Helpers

First Contributions

GitHub Desktop GitHub Desktop Edition

É difícil. É sempre difícil fazer algo pela primeira vez. Especialmente quando se está colaborando, cometer erros não é algo agradável. Mas open source (código aberto) se trata de colaboração e de trabalharmos juntos. Queremos simplificar a forma com que novos colaboradores open source aprendem e contribuem pela primeira vez.

Ler artigos e ver tutoriais pode ajudar, mas o que é melhor do que realmente pôr a mão na massa em um ambiente prático? Este projeto visa guiar e simplificar a forma com que os novatos fazem a sua primeira contribuição. Se quiser fazer a sua primeira contribuição, siga os passos abaixo.

Se você nao tem o Github desktop na sua máquina, instale aqui.

Se você está usando uma versão do Github desktop antes da 1.0, consulte este tutorial.

fork este repositório

Fork este repositório

Fork este repositório clicando no botão fork na parte superior direita dessa página. Isso vai criar uma cópia desse repositório na sua conta.

Clone este repositório

Agora clone esse repositório na sua máquina.

IMPORTANTE: NÃO CLONE O REPOSITÓRIO ORIGINAL. Vá para o seu fork e clone.

Para clonar esse repositório, clique em "Clone or Download" e então clique em "Open in Desktop".

clone este repositório

Uma janela pop up vai aparecer. Clique em "Open GitHubDesktop.exe".

clone este repositório

Depois de clicar em "Open GitHubDesktop.exe" os arquivos serão baixados para o seu computador.

clone este repositório

Agora você copiou os arquivos do repositório first-contributions no github para o seu computador.

Criando uma branch (ramo)

Agora crie uma branch clicando na aba "Current branch" que fica no topo, depois clique em "New branch":

criar uma branch

Nomeie sua branch como . Por exemplo, "add-james-smith"

nomeie sua branch

Clique em Create branch

Faça as mudanças necessárias e commit essas mudanças

Agora abra o arquivo Contributors.md em um editor de texto, vá para o final do arquivo e adicione seu nome, depois salve o arquivo.

Exemplo: Se o seu nome for James Smith, Deve ficar parecido com isso.

[James Smith](https://github.com/jamessmith)

Você pode ver as alterações feitas em Contributors.md no Github Desktop.

checar mudanças

Agora faça commit dessas alterações:

Escreva a mensagem "Add <your-name> to Contributors list" no campo sumary

Substitua <your-name> pelo seu nome.

Clique no botão que diz Commit to add-your-name.

commit suas alterações

Na parte inferior, você pode ver que o commit foi criado com sucesso.

commit suas alterações

Faça o push das mudanças no github

Clique em File -> Options e depois em sign-in to Github.com. Digite seu username e senha do Github.

log-in no Github

Clique no botão Publish na parte superior direita.

push suas alterações

Envie suas alterações para review

Se você for até seu repositório no github, verá o botão Compare & pull request. Clique nesse botão

criando um pull request

Agora envie o pull request.

enviando o pull request

Em breve estarei mesclando todas as suas alterações na branch Master do projeto. Você vai receber um email de notificação assim que as alterações forem integradas.

Qual o próximo passo?

Parabéns! Você acabou de completar o fluxo fork -> clone -> edit -> PR que encontrará diversas vezes como contribuidor!

Comemore sua contribuição e compartilhe com seus amigos e seguidores acessando o web app.

Você pode entrar na nossa equipe no Slack caso precise de alguma ajuda ou tenha alguma dúvida. Entre no Slack.

Tutoriais usando outras ferramentas

Voltar a página principal