O fluxo do projeto, é o mesmo fluxo usado pelo gitflow para amenizar a quantidade de conflitos ao decorrer do processo de contribuição. Logo para que seja possível contribuir com o projeto, é necessário instalar o gitflow.
Os valores padrão para este projeto são:
- **Produção: ** master
- **Desenvolvimento: ** develop
- **Feature: ** feature/
- **Release: ** release/
- **Hotfix: ** hotfix/
- **Bugfix: ** bugfix/
- **Suporte: ** support/
- **Prefixo das versões: ** v
Guia rápido de como usar o gitflow Guia avançado do fluxo
- Faça um fork do projeto original
- Inicie o gitflow:
$ gitflow init
. - Instale as dependências via Composer:
$ sudo composer update
. - Inicie uma nova feature utilizando o gitflow:
$ gitflow feature start <nome_da_feature>
. - Publique o branch criado para a feature:
$ gitflow feature publish <nome_da_feature>
. - Faça as alterações e não esqueça de fazer os commits. É muito importante criar uma descrição detalhada em cada commit!
- Finalize a feature após todas as alterações:
$ gitflow feature finish <nome_da_feature>
. - Crie um Pull Request no projeto original.
- Ah. Não se esqueça de sempre publicar as alterações feitas na branch da feature!
Nosso rastreador de bugs usa vários rótulos para ajudar a organizar e identificar problemas. Aqui estão alguns deles, o que eles representam e como os usa-los:
hotfix
- São erros que são reportados e que estão em versão de produção. Esses devem ser corrigidos o mais rápido possível e criados uma versão de correção usando o gitflow:$ git flow hotfix start 1.0.x
. (Lembrando que o projeto é mantido de acordo com as diretrizes do Semantic Versioning Guidelines. Tente aderir a essas regras sempre que possível.) Ao finalizar a correção, utilize o comando gitflow para filanizar o hotfix:$ git flow hotfix finish 1.0.x
bugfix
- Erros que firam identificados antes da versão/funcionalidade ir para produção ou erros que não "atrapalhem" de forma significativa o que já está em produção. Nesse caso o fluxo de correção é parecido com o do hotfix, porém deve-se utilizar o bugfix do gitflow.feature
- Solicitação para que um novo recurso seja adicionado ou um existente, para ser estendido ou modificado.
Para uma visão geral dobre as labels do projeto, veja a página das labels do projeto.
Os pedidos de recursos são bem-vindos, mas antes de abrir solicitação de uma nova Feature, por favor, tome um momento para descobrir se sua idéia cabe ao alcance e aos objetivos do projeto.
Por favor forneça o máximo de detalhes possível para que os Desenvolvedores possam implementar a ideia.