DEV Community

Ana Caroline Campos
Ana Caroline Campos

Posted on

Documenta seu PR/MR, criatura- PR's template

Print de um mr com 128 alterações sem nenhuma descrição

Aí meu deus, ainda é quarta-feira

Quem nunca viu ou abriu um PR/MR sem descrição, né!? 💩

Agora vamos passar disso aí pra isso aqui:

PR com descrição

Como que faço isso?

Simples, simples, simples.

Github:

  • Add na raiz do seu projeto um arquivo markdown com esse nome pull_request_template.md e taca na main.
  • Insere lá esse markdown aqui e prontinho.
  • No seu próximo PR ela já aperce automágicamente.

Gitlab:

  • Add no seu projeto um arquivo markdown com esse nome .gitlab/pull_request_template.md e taca na main.
  • Insere lá esse markdown aqui e prontinho.
  • Na hora de abrir um MR é só escolher o template na descrição:

Campo select de um template em descrição

Pra que cê vai gastar mais tempo meu?

Bob esponja bobo

Documentação

Pra ter registrado de forma legível para devs e não devs o que foi feito, quando, como, porquê. Isso na hora de demonstrar seu trabalho com sua liderança é ótimo.

Evitar retrabalho

Devs tem que entender código, mas saber porquê você fez as alterações e uma breve explicação das lógicas vai economizar tempo com dúvidas e ajudar num code review menos cansativo. Pegar melhorias na etapa de code review é muito melhor que pegar com pressão do seu tech lead ou PO.

Use, adapte ao seu cenário e seja feliz. E pra deixar ainda mais lindo e de fácil rastreio eu indico DEMAIS esse cara aqui: https://gitmoji.dev/

simpson feliz, é sexta feita

Sentry image

Hands-on debugging session: instrument, monitor, and fix

Join Lazar for a hands-on session where you’ll build it, break it, debug it, and fix it. You’ll set up Sentry, track errors, use Session Replay and Tracing, and leverage some good ol’ AI to find and fix issues fast.

RSVP here →

Top comments (0)

A Workflow Copilot. Tailored to You.

Pieces.app image

Our desktop app, with its intelligent copilot, streamlines coding by generating snippets, extracting code from screenshots, and accelerating problem-solving.

Read the docs

👋 Kindness is contagious

Please leave a ❤️ or a friendly comment on this post if you found it helpful!

Okay