GitHub+Waffle=S2

Introdução editar

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 editar

  • 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 editar

Configuração editar

A configuração da ferramenta é extremamente simples:

  1. Acesse o site: http://waffle.io
  2. Faça login com sua conta GitHub
  3. Adicione o repositório, público ou privado
 
Waffle - Cofiguração das Colunas

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 editar

Badges editar

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 editar

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 editar

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'

Referências editar