Skip to content
Allors Documents

main · 3.3 (unreleased)

Releasing

Maintainers · How-to guide · CurrentMarkdownAgent index

Status: Current. How-to guide for maintainers.

This guide covers building, testing and packing the solution, and how a release reaches nuget.org. task wraps the dotnet commands; without it, dotnet build src/Documents.slnx and dotnet test src/Allors.Documents.Tests do the same work.

Build

Section titled “Build”

Prerequisites: .NET SDK 10.0 and Task.

  • task or task ci — build, test and pack
  • task test — build and run tests
  • task pack — create the NuGet packages in artifacts/nuget
  • task clean — clean build outputs

Versioning is handled by Nerdbank.GitVersioning (version.json).

Release

Section titled “Release”

Pushing a tag vX.Y.Z or vX.Y.Z-rc.N runs release.yml: it builds, tests and packs, publishes both packages to nuget.org through trusted publishing from the nuget-release environment, and creates a GitHub release. The package version comes from version.json, so set it to the tag’s version before tagging.