Estou tentando definir um esquema de trabalho para manter meu repositório no GitHub organizado, mas tá difícil chegar a uma solução.
Minha "ideia":
Pensei em manter no repositório remoto os branch master (default) e develop. O branch master será bloqueado, somente aceitará merge após revisão do pull-request, ou seja, os colaboradores irão enviar suas contribuições para o develop e gerar um pull request deste para o master.
Os branch feature/xpto, hotfix/xpto e outros serão ramificados a partir do develop, não sei se seria interessante ramificar ainda mais com uso de branch topic. Antes de efetuar o merge dos branch locais com develop, deve ser avaliada a necessidade de aplicar um rebase full ou de alguns commit, tendo como objetivo manter uma linha histórica limpa e fácil de ser lida, após o merge local e o push para o remote, no GitHub deverá ser gerado um pull-request do master <- develop
.
No texto assim já foi possível observar algumas dúvidas, vamos consolidar elas e mais algumas:
- Na prática branch topic são realmente úteis e utilizados?
- O rebase local antes do push é uma boa ideia, em que situação seria aconselhável?
- Seria mais aconselhável alterar meu arquivo CHANGELOG.md no branch de develop, ou criar um branch release, alterar lá e depois fazer o merge com
master
edevelop
? - Ao realizar um merge de
master
<-develop
, devo utilizar o merge request (que leva todos os commit + 1 de merge), ou um merge squash (que gera somente 1 commit de saída)? Porque da sua sugestão?
Devido a importância do próximo tópico, resolvi separar o mesmo dos anteriores:
Quando vou realizar um pull-request do master
<- develop
um conflito em sempre irá ocorrer, este é referente ao arquivo CHANGELOG.md, considerando que novos dados sempre são inseridos na parte superior, o git sempre acusará uma alteração para a qual um merge automático não pode ser executado. Como resolver esse problema?
Possíveis soluções:
- No caso do GitHub este sugere fazer um merge do
develop
<-master
, resolver o conflito, aplicar o commit de controle e concluir o pull-request/merge; - Crio uma branch de release a partir de
develop
, faço o merge derelease\xxx
<-master
, resolvo os conflitos, aplico o devido commit, realizo o merge demaster
<-release\xxx
edevelop
<-release\xxx
; - Ou teria outra abordagem "melhor"? Por melhor me refiro a abordagens utilizadas pela comunidade para projetos colaborativos, que comprovadamente são mas eficientes.
Dúvidas finais:
Ao seguir a esteira do git flow, após a criação do branch release, devo fazer merge deste com o mater e develop, considerando que meu master encontra-se protegido no GitHub (aceitando merge só via pull request), devo subir este branch para o remote e gerar o pull-request para o master? E para o develop, faço o merge local e aplico um push?
Obs: Acredito que essa dúvida faça parte da cabeça de muita gente.
hotfix
dodevelop
. Se é quente está em produção, portanto ramifica domaster
. Pode até ser que o pull request seja feito por alguém menos experiente nodevelop
, mas tentar ramificar dele é bem complicado. Eu tratei alguma coisa sobre branches e tags numa resposta. Mais aqui