Este tutorial do GitHub é carinhosamente baseado no DjangoGirls How To Contribute Tutorial que está disponível sob uma licença Creative Commons Attribution-ShareAlike 4.0.

Para este tutorial, usaremos o repositório repositório Briefcase como base para os links e referências.

Introdução e pré-requisitos

Para contribuir com o BeeWare, é necessário o seguinte para começar:

Faça o fork do repositório

Primeiro, bifurque o repositório Briefcase em sua conta pessoal do GitHub:

Botão Fork

Edição de documentação

Mudanças simples

Para alterações simples, como correções de erros de digitação, você pode usar o editor on-line do GitHub editor:

  • Abra sua página de bifurcação local no GitHub,
  • vá para o arquivo README.rst em qualquer capítulo,
  • pressione o ícone Edit (caneta)

e você pode editar o capítulo diretamente no github.com.

Botão Editar

A sintaxe RST é usada para editar as páginas individuais da documentação.

Editor do GitHub

Observação

A captura de tela acima pode não refletir o que está atualmente no repositório do GitHub. O repositório ativo mudará de tempos em tempos. No entanto, o processo de envio de pull requests permanece o mesmo.

Salve suas alterações e crie uma solicitação pull conforme explicado abaixo.

Novo código e alterações complexas

Para adicionar novos códigos, estender classes ou fazer alterações complexas, você precisa obter uma cópia do código em seu computador local.

Use o aplicativo GitHub para o seu sistema operacional (mencionado acima) ou a linha de comando linha de comando git para obter o repositório localmente. Você obtém o endereço do repositório na página inicial de sua própria bifurcação do repositório do GitHub:

git clone git@github.com:yourusername/briefcase.git

Em seguida, crie uma ramificação para suas novas alterações. É útil chamar o ramo de algo relacionado às alterações que você vai fazer.

git checkout -b update_documentation

Faça quaisquer alterações no código e certifique-se de que elas sejam testadas e salvas localmente.

Em seguida, faça o commit das alterações usando git e envie as alterações para seu repositório remoto do repositório remoto do GitHub.

Exemplo:

$ git status
No ramo update_documentation
Arquivos não rastreados:
  (use "git add <arquivo>..." para incluir no que será enviado)

    README.rst

git add README.rst

$ git commit -m "Atualizar a documentação README.rst do Briefcase"
[update_documentation fe36152] Adicionada captura de tela do gitbook
 1 arquivo alterado, 0 inserções (+), 0 exclusões (-)
 modo de criação 100644 README.rst

$ git push
Contagem de objetos: 11, concluído.
Compressão delta usando até 8 threads.
Compactando objetos: 100% (5/5), concluído.
Gravação de objetos: 100% (5/5), 266,37 KiB | 0 bytes/s, concluído.
Total 5 (delta 1), reutilizado 0 (delta 0)
Para git@github.com:yourusername/briefcase.git
   b37ca59..fe36152 update_documentation -> update_documentation

Fazendo uma solicitação pull

Depois de concluir suas alterações, você precisa criar [uma solicitação pull request] (https://help.github.com/articles/about-pull-requests/) no GitHub. O BeeWare será notificado sobre a solicitação pull, revisará suas alterações, sugerirá correções, se necessário, e então pull suas alterações para a versão principal.

Em seu próprio repositório no GitHub, pressione Compare & pull request

image4

Preencha as informações por que essa alteração está sendo feita. O revisor pode ver os detalhes da alteração real, portanto, você não precisa repetir o conteúdo da alteração.

Em seguida, pressione Create pull request.

Os e-mails do GitHub o notificarão sobre o processo de acompanhamento.