Aplicar convenções da equipe em branches, commits e pull requests

Nos planos Pro e Pro AI, a equipe pode reunir suas convenções em um conjunto de modelos no Maestro. Uma pessoa com a permissão adequada configura o conjunto e o ativa para a organização. Entre com sua conta e sincronize o Riff para usar os modelos no seu computador.

Testar a convenção em uma mudança

  1. Crie uma branch para corrigir o checkout. Uma regra como ^fix/[a-z0-9-]+$ aceita fix/empty-cart. O Riff verifica o nome enquanto você digita e mostra o exemplo da equipe ou o padrão quando o nome não corresponde.
  2. No painel de commit, selecione um modelo como fix({area}): {summary}. Preencha a área com checkout e o resumo com handle empty carts. Insira o resultado e revise a mensagem. A primeira linha vira o título e as seguintes formam a descrição.
  3. Ao abrir um pull request, escolha o modelo de PR, preencha as variáveis e aplique-o. Revise o título e a descrição, confira as branches de origem e destino e crie o pedido de revisão.

Entender o que cada validação controla

Os modos Sugestão e Aviso exibem orientação e permitem avançar. O modo Bloqueio impede a criação de uma branch cujo nome descumpra uma regra de bloqueio. No modelo de commit, ele impede inserir o modelo com campos obrigatórios vazios. No modelo de PR, impede aplicar o modelo até preencher esses campos. O texto gerado continua editável. Expressões inválidas de nome de branch são ignoradas na validação.

Para identificar a autoria, quem entrou com a conta pode usar o nome e o e-mail da Gapfy nos commits. A organização pode exigir essa identidade. Quando houver escolha, confira a preferência antes de fazer o commit. Para medir se os títulos já existentes seguem a regra de mensagens ativa, execute uma verificação de conformidade.