Skip to content
Paulo Inácio Prado edited this page Jul 17, 2014 · 32 revisions

Como isso funciona?

Este é o repositório principal do projeto The Walk of Life (TWoLife). Usamos o GitHub para desenvolver colaborativamente o projeto.

Método de trabalho

  1. Cada participante tem uma cópia do projeto (fork), onde faz suas mudanças;
  2. As mudanças são submetidas ao projeto principal apenas por pull requests;
  3. O pull requests deve ser aprovado por pelo menos um outro participante;
  4. Os pull requests aprovados são incorporados (merged) por um participante que não seja o que propôs (pode ser um dos que aprovou).
  5. Tarefas e problemas são geridos colaborativamente com a ferramenta de issues do GitHub.
  6. Reuniões presenciais de planejamento, podem ser chamadas pela mesma ferramenta.

Boas práticas

  • Estude os recursos de interação remota do GitHub e utilize-os para trabalhar com a equipe.
  • Inteire-se de todo o andamento do projeto e não apenas de suas tarefas.
  • Faça todas as solicitações (inclusive de reuniões presenciais) pela ferramenta de issues do GitHub.
  • Visite regularmente o repositório para verificar issues e pull requests.
  • Sempre que possível indique pessoas para issues que criar ou participar (opção de assigment).
  • Se estiver trabalhando em um issue, indique isso com um assigment para você.
  • Quando encerrarem um issue, indiquem isso (close).
  • Sempre que alterar códigos e comentários rode o Doxygen e verifique se houve mudanças na documentação (detalhes aqui).

Para começar: instalação

  1. Leia o guia rápido do GitHub
  2. Instale git (e interfaces se quiser) em seu computador: https://help.github.com/articles/set-up-git
  3. Cadastre-se no GitHub: https://help.github.com/articles/signing-up-for-a-new-github-account
  4. Crie seu fork do TWoLife:
  5. Faça login no GitHub
  6. Vá para o repositório do projeto (https://github.com/piLaboratory/TWoLife)
  7. Clique em fork e siga as instruções em https://help.github.com/articles/fork-a-repo, substituindo o repositório "Spoon-knife" pelo do nosso projeto.
  8. Faça o setup para documentação Doxygen.

Ciclo de trabalho

  1. Fork: implemente suas tarefas em sua cópia de trabalho
  2. Pull-request: quando concluir uma tarefasubmeta ao projeto principal
  3. Merge: avalie e resolva pull-requests de outras pessoas da equipe.

Links

Projeto

Ajuda