Open source05 abr 2026·6 min
Lançando meu primeiro pacote NuGet: lições da v1.0
Versionamento, CI e documentação que as pessoas realmente leem.
LS
Luis Soares
Arquiteto de software — .NET · Azure · IA
[ Open source ]
Publicar um pacote NuGet é metade código, metade operacional: versionamento, CI e docs que alguém abre.
SemVer desde o dia zero
1.0.0 comunica API estável o suficiente para uso externo. Breaking changes = major; features compatíveis = minor; fixes = patch. Gere release notes no pipeline — não na memória.
CI que publica
yaml
- run: dotnet pack -c Release
- run: dotnet nuget push ./nupkg/*.nupkg --api-key ${{ secrets.NUGET_API_KEY }}Documentação
README com install de uma linha, exemplo mínimo e link para API reference. XML comments viram IntelliSense — vale o esforço na v1.
LS
Escrito por Luis Soares — arquiteto de software, rumo ao Microsoft MVP.