Se você já usou changelogs em software para acompanhar correções, novas features e melhorias de performance, por que não aplicar o mesmo conceito à sua vida? O plugin Patchnotes leva essa lógica para dentro do WordPress e cria um sistema simples, estruturado e eficaz para registrar o seu progresso diário, semanal e mensal.
## O que é o Patchnotes?
O Patchnotes é um plugin de notas de atualização pessoais. Cada entrada é um “patchnote” classificado por:
– Tipo: BUG, FEATURE, HOTFIX, PERFORMANCE.
– Ciclo: Daily (Daily Scrum), Weekly (Sprint Review), Monthly (Version Update).
Assim, você cria um histórico padronizado e analisável — perfeito para retrospectivas e para decidir se precisa de um “patch” rápido ou de um “update” mais estrutural na sua rotina.
## Por que usar?
– Clareza: títulos objetivos e conteúdo curto, sem virar diário infinito.
– Padrão: taxonomias dedicadas para Tipos e Ciclos, facilitando busca e filtros.
– Métricas: dashboard com gráficos que mostram sua evolução e gargalos.
– Integração: shortcode para páginas internas e REST API para uso em apps externos.
## Como funciona (em 3 pontos)
1) Categorize as entradas (Log Strategy)
Use os tipos para marcar o contexto:
– [BUG]: hábitos/erros que drenam energia;
– [FEATURE]: novos hábitos/skills a incorporar;
– [HOTFIX]: ajustes rápidos que salvaram o dia;
– [PERFORMANCE]: onde você foi mais eficiente.
2) Implemente ciclos de feedback (Feedback Loops)
– Daily: notas rápidas do dia (5 minutos).
– Weekly: revisão dos padrões da semana.
– Monthly: decidir o foco da nova “versão” (ex.: otimização do sono).
3) Regra Patch vs. Update
– Patch (HOTFIX): correções imediatas e pequenas.
– Update (FEATURE + Monthly): mudanças estruturais com dados suficientes.
1) Ative o plugin em Plugins → Patchnotes.
2) Em Configurações → Patchnotes, ajuste quem pode visualizar (capability).
3) Crie sua primeira nota em Patchnotes → Adicionar nova:
– Título verbo-orientado (“Corrigir cafeína após 18h”).
– Conteúdo curto com contexto.
– Tipo (BUG/FEATURE/HOTFIX/PERFORMANCE) e Ciclo (Daily/Weekly/Monthly).
4) Publique uma página interna de acompanhamento com o shortcode.
### Shortcode
Básico:
Exemplos úteis:
Vá em Patchnotes → Dashboard para visualizar:
– Barras empilhadas: comparação por ciclo e tipo.
– Donut: distribuição geral por tipo.
– Radar: contraste entre ciclos.
Com o tempo, você verá padrões claros: onde os BUGs repetem, quais HOTFIX se tornaram recorrentes (sinal de que é hora de um UPDATE) e onde a PERFORMANCE cresceu.
Integre seus dados aos seus próprios apps:
GET /wp-json/patchnotes/v1/entries?type=bug&cycle=weekly&limit=5
O acesso respeita a capability definida nas Configurações.
## Boas práticas de registro
– Escreva títulos que comecem com verbo e sejam curtos.
– Use o conteúdo para contexto e próximos passos.
– Registre HOTFIX diários; promova a FEATURE quando virar padrão.
– Em cada sprint semanal, note repetições (BUGs) e celebre ganhos (PERFORMANCE).
– Filtros por data no Dashboard.
– Exportação CSV/JSON.
– Bloco Gutenberg para incorporar o painel em páginas internas.
## Para quem quer ir além (referências técnicas)
– Principal: (file:///c:/xampp/htdocs/wp/wp-content/plugins/patchnotes/patchnotes.php)
– Núcleo: [class-patchnotes.php](file:///c:/xampp/htdocs/wp/wp-content/plugins/patchnotes/includes/class-patchnotes.php)
– Configurações: [class-patchnotes-settings.php](file:///c:/xampp/htdocs/wp/wp-content/plugins/patchnotes/includes/class-patchnotes-settings.php)
– REST: [class-patchnotes-rest.php](file:///c:/xampp/htdocs/wp/wp-content/plugins/patchnotes/includes/class-patchnotes-rest.php)
– Dashboard: [class-patchnotes-dashboard.php](file:///c:/xampp/htdocs/wp/wp-content/plugins/patchnotes/includes/class-patchnotes-dashboard.php) e [patchnotes-dashboard.js](file:///c:/xampp/htdocs/wp/wp-content/plugins/patchnotes/assets/patchnotes-dashboard.js)
– Estilos: (file:///c:/xampp/htdocs/wp/wp-content/plugins/patchnotes/assets/patchnotes.css)
—
Instale, registre seus patchnotes, aprenda com os ciclos e evolua como quem versiona um produto: com dados, foco e iteração contínua.