rodri-oliveira-dev Objetivo
Garantir que mudancas nos pacotes CSF.Analyzers.Reliability, CSF.Analyzers.Architecture e CSF.Analyzers.Testing sejam classificadas corretamente como PATCH, MINOR ou MAJOR, mantendo commits semanticos, CHANGELOG.md e documentacao coerentes.
Fonte oficial da versao
A versao publicada e calculada por GitVersion a partir de GitVersion.yml.
O workflow .github/workflows/release.yml usa o output semVer do GitVersion como fonte unica para PackageVersion, tag v{SemVer} e GitHub Release.
Nao atualize VersionPrefix manualmente para preparar release.
Politica de versionamento
O projeto segue Semantic Versioning.
- PATCH: correcao de bug, falso positivo, falso negativo, documentacao publica ou ajuste sem mudanca incompativel.
- MINOR: nova regra ou nova capacidade compativel.
- MAJOR: breaking change, incluindo remocao ou renumeracao de regra, alteracao incompativel de severidade, opcao publica ou empacotamento.
Mudancas de regra
Ao criar ou alterar regra, atualize quando aplicavel:
src/CSF.Analyzers.<Pacote>/RuleIdentifiers.cs;src/CSF.Analyzers.<Pacote>/Rules;tests/CSF.Analyzers.<Pacote>.Tests/Rules;docs/rules/<grupo>/<ID>.md;samples/CSF.Analyzers.<Pacote>.Sample/<ID em PascalCase>;README.md;src/CSF.Analyzers.<Pacote>/AnalyzerReleases.Unshipped.md;CHANGELOG.md.
Checklist antes de finalizar
- A mudanca adiciona nova regra?
- A mudanca altera comportamento de regra existente?
- A mudanca altera severidade padrao?
- A mudanca altera opcao
.editorconfig? - O
CHANGELOG.mdprecisa ser atualizado? - A mensagem de commit corresponde ao incremento esperado pelo GitVersion?
- Se for breaking change, o commit usa
!ou corpo comBREAKING CHANGE:? - README, documentacao, testes, samples e release metadata foram atualizados quando aplicavel?
Regra final
Nao finalize uma tarefa que altere regras, severidades, opcoes .editorconfig, empacotamento NuGet ou documentacao de release publica sem verificar e, quando necessario, atualizar:
CHANGELOG.md
GitVersion.yml
docs/release.md