Skip to content

Como escrever os commits para o git da GeoMK

Integração com o Taiga e Jira (sistema de controle de tarefas)

  • Todos os projetos no git da GeoMK estão interligados com o Taiga e Jira, essa interação dar-se-a através dos commits.

  • Cada Epico, Tarefa, Subtarefa ou Issues tem um número de referência único por projeto que será usado para identificar no commit a que artefato a modificação se refere.

  • Para que o Taiga e Jira possa atualizar automaticamente o status do artefato, devemos incluir no commit a informação da seguinte forma:

    • Taiga: TG-<ref> #<staus-slug>
    • Jira com o exemplo do Portal de Assinatura: PSA-<ref> #<staus-slug>

  • É possível mover mais de um artefato por commit, apesar de não ser muito recomendado. Mais detalhes podem ser vistos em: Movendo mais de um card

Iniciando uma tarefa

> git commit -m "Iniciando .... (TG-1 #in-progress)"

Encaminhando a tarefa para os testes pelo QA

> git commit -m "Desenvolvido o recurso .... (TG-1 #ready-for-test)"

Dando a tarefa como realizada

> git commit -m "Recurso ... está ok  (TG-1 #done)"

Cards e suas slugs

Estas são os estados das cards e suas respectivas slugs, de como devem ser colocadas na lei de formação. Algumas slugs não são apenas de Kambam. Algumas são para as issues e outras para tarefas. Estas são utilizadas pelo analista e QA. - Novo: new - Pronto: ready - Em Andamento: in-progress - Pronto para Teste: ready-for-test - Terminado: done - Arquivado: archived - Fechado: closed - Precisa de informação: needs-info - Rejeitado: rejected - Adiado: postponed

Movendo mais de um card

É recomendado mover um artefato por vez. É possível, entretanto, mover mais de um arterfato ou card por commit. Isso é algo útil para situações de começo do projeto, onde muitas atividades são feitas por commit, ou por analistas de sistema e QA, quando enviarem seus relatórios.

Para Isso, é necessário seguir os passos:

Realize um commit comum, sem usar o -m e a mensagem.

> git commit

Isso era abrir o editor de mensagem de commit, provavelmente o nano

Escreva a mensagem, e em cada linha, digite a regra de formação

Projeto djnxxxx foi criado (TG-1 #in-progress)
App de usuario criado (T2-@ #in-progess)
# Please enter the commit message for your changes. Lines starting
# with '#' will be ignored, and an empty message aborts the commit.
# No ramo master
# Your branch is up-to-date with 'origin/master'.
#
# Mudanças a serem submetidas:
#       modified:   mkdocs/docs/git_commit_format.md
#

Se for o editor nano, salve(ctrl-o) e feche(ctrl-x). Feito isso o commit é realizado e os cards simultâneos foram movidos. Em alguns Pcs, o editor aberto pode ser o Vim. Provavelmente você usa o vim se ele abriu e não o nano, logo você deve saber editar e fechar o arquivo.