Eu gostaria de contribuir para um determinado projeto no GitHub . Devo bifurcar ? Ramificá- lo? O que é recomendado e como fazê-lo?

Idealmente você:

1. Bifurcar o projeto
2. Faça uma ou mais confirmações bem comentadas e limpas no repositório. Você pode criar uma nova ramificação aqui se estiver modificando mais de uma parte ou recurso.
3. Execute uma solicitação pull na interface da web do github.

se for uma nova solicitação de recurso, não inicie a codificação primeiro. Lembre-se de postar um problema para discutir o novo recurso.

Se o recurso for bem discutido e houver +1 ou o proprietário do projeto o aprovou, atribua o problema a si mesmo e siga as etapas acima.

Alguns projetos não usam o sistema de solicitação de recebimento. Verifique com o autor ou a lista de discussão a melhor maneira de recuperar seu código no projeto.

Para adicionar à resposta de Yann , depois de criar um projeto, você pode desenvolver em qualquer ramo que desejar (um novo ou um do projeto original)

Lembrar de:

• adicione o projeto original como um controle remoto (forma diferente ' origin', pois originseria seu próprio repositório, resultado do fork)
• redefina sua ramificação sobre a ramificação do repositório original que você deseja contribuir.
  É importante que sua solicitação de recebimento resulte em fusões de avanço rápido.
  Veja por exemplo:
  • " Puxe novas atualizações do repositório original do Github para o repositório bifurcado do Github ".
  • " Atualização do repositório bifurcado no github "
  • " Git trabalhando garfo com atualizações "

Para adicionar às respostas de Yan e VonC, este é um bom recurso do próprio github: http://help.github.com/forking/

Também não deixe de olhar na barra lateral direita, sob o cabeçalho "colaborando".

Há um ótimo vídeo do Railscast aqui que mostra o processo. Ele também possui várias dicas boas, como mostrar como determinar em qual filial você deseja trabalhar ao contribuir, usar testes, submódulos etc.

Embora esse screencast seja focado principalmente nos desenvolvedores do Rails, a maioria das informações é válida para contribuir com qualquer projeto de código aberto.

O Github tem muitas maneiras de colaborar com um projeto. O modelo que a maioria dos projetos usa é um modelo de solicitação de recebimento. Comecei um projeto para ajudar as pessoas a fazer sua primeira solicitação de recebimento do GitHub. Você pode fazer o tutorial prático para fazer seu primeiro PR aqui

O fluxo de trabalho é simples como

• Bifurque o repositório no github
• Clone o repositório em sua máquina
• Faça uma filial e faça as alterações necessárias
• Envie suas alterações para o seu fork no GitHub git push origin branch-name
• Vá para o seu fork no GitHub para ver um Compare and pull requestbotão
• Clique nele e forneça os detalhes necessários

O lornajane possui uma postagem no blog que explica bem o processo: http://www.lornajane.net/posts/2010/contributing-to-projects-on-github

Fluxo de trabalho técnico

Eu sugeriria o seguinte fluxo de trabalho:

1. Bifurcar o repositório (via interface da web do GitHub: botão "Bifurcar")
2. No seu repositório bifurcado, copie o URL

3. Clone (na linha de comando)

   git clone <url-from-your-workspace>

4. Digite o diretório que acabou de ser criado e crie uma ramificação

   cd <directory> git checkout -b <branchname>

5. Agora faça suas alterações

6. Você pode criar uma ou mais confirmações após cada alteração:

   commit -a

7. Quando terminar, faça suas alterações

   git push origin <branch>

8. Na sua linha de comando, você deve ver um URL para criar o PR . Visite o URL e clique no botão para criar um PR.

9. Caso contrário, visite o repositório no navegador e ele oferecerá um botão para criar a solicitação pull

É isso aí.

Então, basicamente, você bifurcou o repositório no seu espaço de trabalho, criou um novo ramo e empurrou esse novo ramo.

Se você posteriormente criar mais PR a partir do mesmo repositório clonado, deverá sincronizar (obter as alterações mais recentes do repositório original) antes de criar outra ramificação para outro PR:

git checkout master
git remote add upstream <url-of-original-repo>
git pull upstream master

Outras considerações:

• o projeto pode ter diretrizes de contribuição: procure um arquivo CONTRIBUTING.rst ou .md
• convém seguir as diretrizes de codificação do projeto
• convém delinear sua ideia como problema primeiro
• convém consultar a guia Pull Requests do projeto e verificar se há PR aberto, PR mesclado

Essas sugestões estão aqui para poupar o trabalho de colocar o trabalho em um PR que não será mesclado. Se houver atividade no projeto e o PR for mesclado, este é um bom sinal. Se houver diretrizes de contribuição, siga-as.

Seja sempre cortês. Lembre-se, os mantenedores do projeto não são de forma alguma obrigados a mesclar seu PR. Você tem algo valioso para adicionar ao projeto?