Pular para o conteúdo principal

Revisões

Uma revisão é o momento em que o seu trabalho sai do rascunho individual e entra em um processo de aprovação. É o equivalente a abrir um pull request — só que dentro do RuleForge, com o conteúdo e o contexto certos para quem vai revisar.

Quando abrir uma revisão​

Abra uma revisão quando:

  • o conteúdo está pronto para ser avaliado por outra pessoa;
  • a política do seu projeto exige aprovação antes da publicação;
  • você quer deixar o histórico formal de quem pediu mudanças e quem aprovou.

Para rascunhos pessoais ou exploração, use um workspace — ele não sai da sua mão até você decidir.

Como uma revisão avança​

Uma revisão passa por estes momentos:

  • Rascunho — você ainda está preparando.
  • Em revisão — você pediu avaliação; revisores podem comentar.
  • Mudanças solicitadas — o revisor apontou ajustes antes de aprovar.
  • Aprovada — a revisão foi aceita e o conteúdo pode avançar para publicação.
  • Publicada — a versão correspondente foi publicada.

A interface indica o momento atual em cada revisão.

Passo a passo​

  1. No projeto, clique em Nova revisão.
  2. Dê um título curto e descreva o objetivo (por exemplo, "Regras de detecção SSH — maio").
  3. Confirme que o conteúdo já foi validado e, se aplicável, que a regressão está limpa.
  4. Informe quem deve revisar.
  5. Aguarde a análise. Comentários aparecem na própria tela da revisão.
  6. Após aprovação, crie a versão e publique.

Boas práticas​

  • Escreva objetivo e contexto — isso economiza idas e vindas.
  • Responda comentários marcando a resolução em cada um.
  • Resolva pedidos de mudança antes de pedir uma nova rodada.
  • Use revisões curtas e focadas; revisões gigantes costumam ficar paradas.

Perguntas frequentes​

"Não consigo aprovar a revisão"​

Seu papel atual pode dar direito a comentar, mas não a aprovar. Consulte Papéis e permissões ou peça ao responsável da organização para ajustar.

"A revisão foi aprovada, mas a publicação continua bloqueada"​

Revisões resolvem a parte editorial, mas a publicação também depende de:

  • validação sem erros;
  • regressão limpa;
  • score mínimo de qualidade (se a sua política exigir).

Consulte a aba de versões e quality gates para ver qual critério está pendente.

"Minha organização não tem a tela de revisões"​

A funcionalidade depende do plano. Veja Cobrança e planos.