Skip to content
Bernardo Niebuhr edited this page Oct 30, 2018 · 3 revisions

Workflow deste repositório

Este é o repositório principal de códigos do grupo de análise de dados de movimentação de Onça-Pintada. Usamos o GitHub para desenvolver colaborativamente os códigos.

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

  • Faça uma cópia de trabalho (clone) do repositório em seu computador, com apontadores para o seu fork no GitHub e também para o repositório principal. Detalhes https://help.github.com/articles/syncing-a-fork/.
  • A cada vez que começar a trabalhar nos códigos, sempre sincronize sua cópia com a do repositório principal.
  • Ao fim do trabalho sempre submeta suas modificações ao seu fork no GitHub.
  • 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).

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 repositório:
  5. Faça login no GitHub
  6. Vá para o repositório do projeto (https://github.com/piLaboratory/jaguar-codes)
  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.

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.

Ajuda