Skip to content

docs: adicionar template de pull request - #466

Open
fernanduandrade wants to merge 6 commits into
he4rt:4.xfrom
fernanduandrade:feature/pull-request-template
Open

docs: adicionar template de pull request#466
fernanduandrade wants to merge 6 commits into
he4rt:4.xfrom
fernanduandrade:feature/pull-request-template

Conversation

@fernanduandrade

Copy link
Copy Markdown
Contributor

Summary

Atualmente, o repositório não possui um padrão definido para a descrição de Pull Requests. Como consequência, cada PR é estruturado de forma diferente, dificultando a revisão, a reprodução dos testes e a identificação das alterações realizadas.

Este PR adiciona um template de Pull Request para padronizar a abertura de novas contribuições, orientando os colaboradores a documentarem:

  • O contexto e objetivo da alteração;
  • As principais modificações realizadas;
  • O plano de testes utilizado para validação;
  • Evidências visuais, quando aplicável;
  • As issues relacionadas.

Além de tornar o processo de revisão mais consistente, este template também serve como um guia para novos contribuidores. Como a comunidade incentiva a participação de pessoas com diferentes níveis de experiência, o template fornece uma orientação clara sobre quais informações devem ser incluídas em um Pull Request, tornando o processo de contribuição mais simples, organizado e acolhedor.

Alterações

  • Adicionado template padrão para Pull Requests.
  • Incluída seção Summary para contextualização da alteração.
  • Incluída seção Alterações para listar as modificações realizadas.
  • Incluído Plano de Testes em formato de checklist para documentar os passos de validação.
  • Incluída seção Evidências para anexar prints, GIFs ou vídeos quando aplicável.
  • Incluída seção Issues Relacionadas para vincular automaticamente o PR às issues correspondentes.

@fernanduandrade
fernanduandrade requested a review from a team July 30, 2026 10:35
@coderabbitai

coderabbitai Bot commented Jul 30, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Central YAML (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 3487e2b7-e36e-4847-8faa-86871f236fbb

📥 Commits

Reviewing files that changed from the base of the PR and between 44fe067 and c57cf89.

📒 Files selected for processing (1)
  • .ai/guidelines/workflow/05-pull-requests.blade.php
🚧 Files skipped from review as they are similar to previous changes (1)
  • .ai/guidelines/workflow/05-pull-requests.blade.php

📝 Walkthrough

Walkthrough

Adds a Portuguese GitHub pull request template with prompts for context, changes, validation, evidence, and related issues. Adds workflow guidance that requires agents to use and preserve the template, document validation commands, reference related issues, avoid fabricated evidence, and describe behavioral impact.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed O título descreve de forma clara e concisa a adição do template de pull request.
Description check ✅ Passed A descrição está relacionada às alterações e explica o objetivo e as seções do template.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.github/pull_request_template.md:
- Around line 18-20: Update the pull request template placeholder rows in all
referenced sections, including the incomplete “Closes #” entry, so they are
hidden inside HTML comments or replaced with clear prompts that cannot be
submitted as real PR content.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Central YAML (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 2f7b38ba-0f7b-497e-96d1-d84c19698258

📥 Commits

Reviewing files that changed from the base of the PR and between 405a13d and b92ec80.

📒 Files selected for processing (1)
  • .github/pull_request_template.md

Comment thread .github/pull_request_template.md
@fernanduandrade fernanduandrade added github_actions Pull requests that update GitHub Actions code type:docs Documentation labels Jul 30, 2026
@YuriSouzaDev

YuriSouzaDev commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Entendo seu ponto e faz sentido e até torna a leitura mais prática com o tempo.

Mas acho que cabe uma discussão do que acontece se um PR não seguir esse template, terá que ser refeito? Ou não será aceito devido a descrição do PR mesmo solucionando o problema?

Por não ter um padrão voce sentiu dificuldade em entender algum PR?

Não sei seria possivel dentro do ci/cd validar isso, mas cabe averiguar.

@fernanduandrade

Copy link
Copy Markdown
Contributor Author

Entendo seu ponto e faz sentido e até torna a leitura mais prática com o tempo.

Mas acho que cabe uma discussão do que acontece se um PR não seguir esse template, terá que ser refeito? Ou não será aceito devido a descrição do PR mesmo solucionando o problema?

Por não ter um padrão voce sentiu dificuldade em entender algum PR?

Não sei seria possivel dentro do ci/cd validar isso, mas cabe averiguar.

Já me foi solcitado incluir algumas descrições na PR e que fazia sentido incluir para deixar o contexto dela um pouco melhor. Por não ter um padrão acreditava que estava ok a descrição da PR, mas tinha como melhorar.

A ideia é que não seja um fator obrigatório a seguir e também não invalidar as PR que não estejam no padrão do template, mais apenas orientar, servir de guia e já ter um texto pronto com alguns campos para facilitar a abertura a PR.

@YuriSouzaDev

YuriSouzaDev commented Aug 1, 2026

Copy link
Copy Markdown
Contributor

Já me foi solcitado incluir algumas descrições na PR e que fazia sentido incluir para deixar o contexto dela um pouco melhor. Por não ter um padrão acreditava que estava ok a descrição da PR, mas tinha como melhorar.

A ideia é que não seja um fator obrigatório a seguir e também não invalidar as PR que não estejam no padrão do template, mais apenas orientar, servir de guia e já ter um texto pronto com alguns campos para facilitar a abertura a PR.

Então a maioria das perguntas foram respondidas, somente sobre PR que não seguir o template será considerado "errado"? Poderia marcar quem te solicitou se achar conveniente pra responder isso

@sirelves

sirelves commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

Faz falta mesmo, procurei aqui e não tem template nenhum no repo hoje. A estrutura tá boa, principalmente separar plano de testes de evidências.

Duas sugestões.

O plano de testes podia já vir com make check e make test no checklist. São os dois gates que o CLAUDE.md manda rodar antes de commitar, e quem mais precisa dessa informação é exatamente o público que o template quer acolher. Hoje a pessoa só descobre lendo o CLAUDE.md inteiro ou tomando CI vermelho.

A outra é mistura de idioma. Tem "Summary" convivendo com "Alterações", "Plano de Testes", "Evidências" e "Issues Relacionadas". Escolhe um dos dois. Como o template existe justamente pra receber gente nova da comunidade, eu iria de português inteiro e viraria "Resumo".

Nit bobo: o Closes # lá do final tá fora do comentário HTML, então ele nasce como texto solto no corpo de todo PR aberto. Ou entra pra dentro do comentário junto com os exemplos, ou fica valendo como campo a preencher mesmo.

@gvieira18 gvieira18 linked an issue Aug 3, 2026 that may be closed by this pull request
@fernanduandrade

Copy link
Copy Markdown
Contributor Author

Faz falta mesmo, procurei aqui e não tem template nenhum no repo hoje. A estrutura tá boa, principalmente separar plano de testes de evidências.

Duas sugestões.

O plano de testes podia já vir com make check e make test no checklist. São os dois gates que o CLAUDE.md manda rodar antes de commitar, e quem mais precisa dessa informação é exatamente o público que o template quer acolher. Hoje a pessoa só descobre lendo o CLAUDE.md inteiro ou tomando CI vermelho.

A outra é mistura de idioma. Tem "Summary" convivendo com "Alterações", "Plano de Testes", "Evidências" e "Issues Relacionadas". Escolhe um dos dois. Como o template existe justamente pra receber gente nova da comunidade, eu iria de português inteiro e viraria "Resumo".

Nit bobo: o Closes # lá do final tá fora do comentário HTML, então ele nasce como texto solto no corpo de todo PR aberto. Ou entra pra dentro do comentário junto com os exemplos, ou fica valendo como campo a preencher mesmo.

Bem pontuado realmente fica bem mais coerente

Inclui no modelo esses checks e mantive o padrão pt-BR.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.ai/guidelines/workflow/05-pull-requests.blade.php:
- Around line 7-15: Revise the guidance around pull request creation and the
“Required behavior” section so using `.github/pull_request_template.md` is
recommended rather than mandatory. Replace blocking language such as “MUST” and
required-section enforcement with advisory wording, and explicitly state that a
missing or nonconforming template does not block the pull request.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Central YAML (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: eb4483af-3a9d-43e9-8124-47feea88155a

📥 Commits

Reviewing files that changed from the base of the PR and between b92ec80 and 44fe067.

📒 Files selected for processing (2)
  • .ai/guidelines/workflow/05-pull-requests.blade.php
  • .github/pull_request_template.md

Comment thread .ai/guidelines/workflow/05-pull-requests.blade.php Outdated

@stherzada stherzada left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

github_actions Pull requests that update GitHub Actions code type:docs Documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Sugestão: Adicionar templates para Issues

5 participants