Waffle

Introdução

Waffle

O Waffle.io é uma ferramenta de gerência de projeto para equipes de desenvolvimento que usam o GitHub como repositório principal para seus projetos. Tendo em vista os diferentes perfis que podem compor uma equipe, a ferramenta cria um ambiente que facilita a organização de Issues, com um quadro (editável) de cards (cartas). Neste quadro é possível mover os cards para o estado atual da Issue, por padrão:

Backlog
Ready
In progress
Done

O objetivo é auxiliar na adoção de gerência de projeto no nível do repositório, usando recursos do próprio GitHub, como as tags para organização das Issues, pull requests são transformados em cards, e os milestones (marcos) criados no GitHub podem ser usados para melhorar ainda mais a experiência com a ferramenta.

Vantagens de usar Waffle.io

Fácil Configuração
Escolha entre o quadro do Waffle.io ou entre a lista de issues do GitHub
Mantenha uma fonte confiável do processo de desenvolvimento
- É possível editar, comentar e fechar os cards (Issues) no próprio waffle.io, facilitando a comunicação entre os membros do time.
Faça Tracking do trabalho que você já faz
- É possível adicionar e criar rótulos no Waffle.io e usar palavras reservadas nos commits para manipular os cards no quadro do waffle.io
Potencialize a interação entre o Time

How To

Configuração

A configuração da ferramenta é extremamente simples:

Acesse o site: http://waffle.io
Faça login com sua conta GitHub
Adicione o repositório, público ou privado

Uma customização opcional, mas muito interessante, no Waffle.io é a alteração das colunas disponíveis. É possível criar uma coluna para aceitação de pull requests por exemplo, e configura-la para que cada vez que um pull request for enviado, a Issue seja transferida para aquela coluna.

Ferramentas

Badges

Logo que um repositório incorpora o Waffle.io, é requisitado um pull request para adicionar um badge no README.md do projeto. É possível alterar a badge pelo menu, ou pelo próprio arquivo no repositório.

Atenção: É possível criar uma badge para cada coluna do quadro Waffle.io, contanto que ela possua um rótulo (Label).

Exemplo de alteração no readme.md para visualização do badge no GitHub do projeto:

Badges Dinâmicas Waffle

[![Stories in Ready](https://badge.waffle.io/seu-projeto/projeto.png?label=ready&title=Ready)]
(https://waffle.io/seu-projeto/projeto)
[![Stories in Progress](https://badge.waffle.io/seu-projeto/projeto.png?label=in progress&title=In Progress)]
(https://waffle.io/seu-projeto/projeto)

Gráficos

Também é possível apresentar na página inicial do repositório (README.md) um gráfico que mostra as Issues e os Pull Requests fechados nas últimas semanas. É possível fazer filtrar por data e pelo tipo de issue.

Exemplo no readme.md:

[![Throughput Graph](https://graphs.waffle.io/seu-projeto/projeto/throughput.svg)](https://waffle.io/sseu-projeto/projeto//metrics)

Manipulando Issues

Uma das maiores vantagens no uso do Waffle.io é a possibilidade de incorporar o otimizar o fluxo de desenvolvimento sem gerar mais trabalho e sobrecarregar o Time com tarefas desnecessárias.

O primeiro passo para que o Waffle.io controle o fluxo de desenvolvimento é criar uma branch que contenha o número da issue.

$ git checkout -b mybranch-#21

Em seguida, submeta a branch para o servidor remoto:

$ git push --set-upstream origin mybranch-#21

Nesse ponto, a Issue já é tranferida para a coluna In Progress
Quando terminar seu trabalho e quiser fechar a issue, vá para o GitHub e faça um pull request para sua branch principal. 'É importante' que o título do pull request seja closes #21. Esse título fara com que a Issue seja movida para Done, quado pull request for aceito.
É possível configurar uma coluna que monitora os pull requests, no menu de configurações do projeto.
Quando o pull request for aceito e o merge entre as branchs for realizado, a issue vai diretamente para a coluna 'Done'