100 PaperCuts

Project Goal

Bem-vindo ao projeto 100 Paper Cuts! Objetivo deste projeto é identificar e corrigir bugs de alta visibilidade e fáceis de corrigir no Portal Liferay. É dirigido pela imensa comunidade da Liferay, com voluntários que trabalham para identificar, priorizar, atribuir, e resolver problemas conhecidos.

Equipe

 

O Processo

1. Identificar os problemas. A comunidade sempre foi incentivada a votar em questões que ela gostaria de ver corrigida o mais cedo possível. Isto permitiu que os gestores da Liferay priorizem corretamente os bugs com base no feedback da comunidade. Com o programa de 100 Paper Cuts, o voto se tornou ainda mais importante. Nós usamos o mesmo sistema de votação para identificar bugs de alta visibilidade e de fácil correção. O processo do 100 Paper Cuts começa com um período de tempo em que voto adicional é incentivado. Se você quiser votar em algum problema, por favor leia o processo de votação.

2. Atribuir e Corrigir.Durante um período de duas semanas, cerca de 10 problemas são selecionados e corrigidos com base no seu impacto e esforço necessário para corrigir. Temos como objetivo selecionar bugs que não levem mais de um dia de desenvolvimento para sua correção. Este período é chamado de "Comunidade Sprint" e representa uma quantia fixa de tempo para corrigir os problemas identificados. Uma vez que o prazo de sprint seja longo, o processo é repetido.

3. Acompanhar o progresso.Durante e após o sprint, os problemas são rastreados, até que seja inserido em um ou mais releases do Liferay.

Correção de problemas

A página de Contribuição da Comunidade descreve como contribuir com o Liferay. Para o programa 100 PC, as contribuições são na forma de correções de bugs. O objetivo do programa é fazer com que o bug atinja o estado de Resolvido pela Comunidade. Uma vez neste estado, o pessoal Liferay conduzirá a correção até o codigo fonte base. Para mais informações sobre o desenvolvimento e correções de bugs no Liferay, consulte os seguintes recursos:

Para corrigir uma papercut:

1. Verifique se você tem uma conta no issues.liferay.com. Se você não tiver se inscreva para uma (é grátis!).

2. Procure a lista de questões em aberto. Para qualquer problema que você acha que é um papercut, independentemente de querer ou não trabalhar nele, você deve marcar o problema adicionando o seguinte texto em um comentário: "This issue is a backlog candidate for the 100 PaperCuts program. Please consider participating! See http://liferay.com/community/100-papercuts".

3. Selecione um problema do backlog para trabalhar em um determinado sprint.

4. Leia e entenda o assunto que você quer trabalhar. Tente reproduzir o problema na última versão (trunk) do Liferay. Se você não pode reproduzi-lo no trunk, e o bug foi relatado em uma versão anterior, tente reproduzi-lo usando essa versão. Se você pode reproduzi-lo na versão anterior, mas não na versão mais recente, então o erro provavelmente já está corrigido! Adicione um comentário sobre o bug indicando que você acha que está corrigido, e se o relator original concordar, a Liferay cuidará a resolução deste problema.

5. Se você pode reproduzi-lo na última revisão, então a primeira coisa a fazer é adicionar um comentário à questão usando o modelo: "This issue is currently being addressed in Sprint X the 100 PaperCuts program.  Please see http://liferay.com/community/100-papercuts".  Este comentário vai permitir-nos filtrar e encontrar Papercuts usando filtros do JIRA

6. Corrija o problema usando as diretrizes de desenvolvimento acima e ferramentas.

7. Uma vez que o problema for corrigido, você deve gerar um patch usando usando svn diff > LPS-[ISSUE]-build-[SVN REVISION].patch. Por exemplo, para gerar um patch para o LPS-12322 na revisão 43533, o nome seria LPS-12322-build-43533.patch.

8. Anexar esse patch ao problema usando o recurso de anexar do JIRA. Junto com o patch, adicionar um comentário explicando a natureza da sua correção. Além disso, peça ao relator original para revisar e testar a sua correção, e peça-lhes também para clicar no botão "Aceitar Contribuição" depois de terem verificado a sua correção.

9. Importante! Clique no botão "Contribuir com Solução" no ticket.  Esta é uma indicação de que o problema foi resolvido por você, e agora está nas mãos do relator original do bug. É responsabilidade dele revisar e testar a sua correção, e clicar em "Aceitar Contribuição". Isto irá mover o ticket para o estado "Resolvido pela Comunidade", e o programa de gestão da Liferay vai conduzi-lo para uma versão futura do Liferay. Agora, está pronto! Parabéns!

10. Se o relator original não está mais ativo e você não obter uma resposta depois de uma semana ou mais, informe a equipe, e vamos entra em contato com o relator, e na pior das hipóteses, aceitá-lo por ele (depois de testar é claro).

Good luck, and good hunting!