6.0.0

As part of this release we had 1594 commits.

The changes that were introduced can be found within each of the pre-releases:

6.0.0-alpha.1
6.0.0-beta.1
6.0.0-beta.2
6.0.0-beta.3
6.0.0-beta.4
6.0.0-beta.5
6.0.0-beta.6
6.0.0-beta.7
6.0.0-rc.1
6.0.0-rc.2

For additional information check the BREAKING_CHANGES.md

Breaking changes

• #1054 Rename tag to label
• #2210 Remove Verbosity old values parsing
• #2325 [Improvement] Remove legacy version variables and related configuration options in v6
• #2997 Sunset support for .NET Framework 4.8
• #2998 Sunset support for .net50
• #3166 [Feature] Sunset .net core 3.1
• #3190 Change the logic inheriting BranchConfiguration from parent branch if the IncrementStrategy is set to Inherit
• #2848 [Bug] Default configuration is used when config file specified via -config not found
• #3235 Create new fallback and unknown section in GitVersionConfiguration an…
• !3805 Refactor caching system in GitVersion
• #3229 [Breaking Change] Remove init wizard for v6

Bugs

• #3020 [Bug] Closing pull request from hotfix to support failed to inherit Increment branch configuration
• #3101 [Bug] Version not generated correct when creating a feature branch from a release branch
• #3105 [Bug] Version of commit in develop merged to master changes if master is tagged
• #3151 [Bug] SemVer of a feature branch started from a release branch gets decremented
• #3154 [Bug] Merging develop to release branch makes alpha version jump back
• #3187 [Bug] Wrong semver calculation when making a PR from a hotfix branch to main branch
• #3282 [Bug] tag-prefix still seems to be optionally considered
• #964 When assembly-versioning-scheme is set to none, AssemblyInfoBulider should not emit AssemblyVersion attribute
• #1518 Stack overflow due to infinite loop falling back to branch config
• #1789 track-merge-target in branch config not working
• #2336 [Bug] Hotfix branch name not taken as version source
• #3052 [Bug] track-merge-changes produces unexpected result when combining hotfix and support branches
• #3341 [Bug] Failed to parse 0.1 into a Semantic Version (v 6.0.0-alpha.1)
• #1579 Azure Pipelines - Pull Request Inheritance
• #2134 [Appveyor] InvalidSpecificationException: the given reference name '[branch]' is not valid
• #2285 [Bug] Incrementing steps does not occur when I expect them
• #2287 [Bug] Wrong version calculation
• #2347 [Bug] When PreleaseLabel is empty, the PreleaseTag is not correctly generated
• #2597 [Bug] gitversion seems to pick the wrong base version, when using git flow while tagging on develop.
• #2667 Commit message can bump major version twice in GitFlow
• #2693 [Bug] VersionInBranchNameVersionStrategy only considers the release branch
• #2821 Pull Request Version Calculation Not Based on source branch
• #2917 Manually incrementing the version
• #3103 [Bug] GitLab: Branch names cannot contain the word 'refs'
• #3137 [Bug] Minor version increased instead of the prerelease tag
• #3183 [Bug]? no minor version detected on pull request that contains organization name
• #3397 [Bug] Normalization takes a very long time
• #3422 [Bug] wrong patch count after merging Release branch
• #3436 [Bug] GitVersion behaves different if it is used the first time where the fallback version strategy applies
• #3438 [Bug] Consider pre-release tags only when they matching with the label name on branch
• #2533 In GitVersion.MsBuild 5.6.3, AfterTargets="GetVersion" causes msbuild warning '"WriteVersionInfoToBuildLog" task could not be loaded'
• #2595 [Bug] GitVersion.MSBuild broken for WiX setup projects
• #2606 [Bug] The 'Documentation', 'Failing test', and 'Improvement request' issue templates lack proper descriptions.
• #2881 [Bug] GitVersion is extremely slow (25 minutes)
• #3212 [Bug]Regression perfomance since 5.2.4
• #3442 [Bug] Performance issue in pre 6.0.0-beta.1
• #3450 GitVersion 6.0-beta.1 : Error on WriteVersionInfoToBuildLog with can't load System.Runtime 6.0.0.0 on a .NET 7 project
• #3487 [Bug] Regression: GitVersion 5.12.0 uses only MajorMinorPatch from tag instead of SemVer
• #2462 [Bug] Using output of showconfig for config file results in invalid config
• #3606 [Bug] CS0436 may be present with InternalsVisibleTo
• #3654 [Bug] GitVersion forces a C# language for projects that aren't C#
• #3704 [Bug] MSB4062 The "WriteVersionInfoToBuildLog" task could not be loaded
• #3716 [Bug] Error when trying to set "Branch Increment mode"
• #3739 [Bug] The configuration JSON schemas use the wrong properties for default values and assign bad regex patterns
• #3832 [Bug] 6.0 Beta 4 gitversion.msbuild with dotnet build
• #3108 [Bug] Version not generated correct when creating a feature branch from a develop branch
• #3316 [Bug] BUILD_SOURCEBRANCH is assumed to be relevant
• #3570 [Bug] Incrementing patch version automatically on main without tags nor specific commit messages
• #3644 [Bug] 5.12 bumps major based on the previous merges instead of the last tag and branch convention
• #3656 [Bug] CommitsSinceVersionSource is counting from latest minor tag or first tag instead of latest tag
• #3699 [Bug] GitVersion calculates the wrong version after main is merged back to develop
• #3757 Version not bumped if an irrelevant tag exists in latest commit
• #3074 [Bug] ignore parameter does not ignore everything
• #3206 [Bug] GitVersion mainline always returns latest version based on master branch history, even if building for an older commit
• #3427 [Bug] Ignoring a SHA in the configuration does not seem to exclude it from the version calculation
• #2394 [Bug] GitVersionTask: VersionSource is set to wrong tag

Dependencies

• #3044 (deps): Bump Buildalyzer from 3.2.2 to 4.1.2
• #3388 (deps): Bump YamlDotNet from 13.0.0 to 13.0.1
• #3389 (deps): Bump Microsoft.NET.Test.Sdk from 17.4.1 to 17.5.0
• #3411 (deps): Bump Microsoft.Build.Utilities.Core from 17.4.0 to 17.5.0
• #3439 (deps): Bump YamlDotNet from 13.0.1 to 13.0.2
• #3440 (deps): Bump NUnit.Analyzers from 3.6.0 to 3.6.1
• #3475 (deps): Bump LibGit2Sharp from 0.27.0-preview-0182 to 0.27.2
• #3482 (deps): Bump YamlDotNet from 13.0.2 to 13.1.0
• !3728 (deps): Bump YamlDotNet from 13.7.0 to 13.7.1
• !3784 (deps): Bump Polly from 8.1.0 to 8.2.0 in /src
• !3798 Remove JetBrains.Annotations dependency
• !3799 Remove System.Net.Requests package reference
• !3824 (deps): Bump LibGit2Sharp from 0.28.0 to 0.29.0 in /src
• !3972 (deps): Bump LibGit2Sharp from 0.29.0 to 0.30.0
• !4095 (deps): Bump YamlDotNet from 15.3.0 to 16.0.0 in /src

Documentation

• #2665 [Docs] issue templates are missing descriptions
• #3627 [Docs] Fix "Conventional Commit" commit message format
• #3740 [Docs] Git push does not transfer tags
• !3858 Docker documentation (v6)
• #3937 [Docs] Update the docs for Azure Pipelines and Github actions - redirect to the gittools/actions
• !4041 Fix typo in track-merge-target and track-merge-message
• #4042 gitversion from container image default behaviour differs from other installation methods
• #4043 [Documentation]: Documenting the GitFlow workflow and create sequence diagrams
• #4060 [ISSUE]: init command still shown in the help output
• #4063 [Documentation]: Documenting the GitHubFlow workflow and create sequence
• #4078 [ISSUE]: Update the docs on DockerHub and specify the usage when running in a CI environment
• #3918 [Docs] Mark API published before v6.0.0 release

Features

• #3131 Implement SemVer strict parsing
• #3169 [Feature] Add support for .net 7.0
• #2874 [Feature Request] Add JSON schema to help configure 'GitVersion.yml'
• #3302 [Feature] Introducing a new branch related property with name track-merge-message
• #3305 [Feature] Introducing a new templating mechanism to support different workflows
• #3396 Using effective branch configuration
• #3400 [Feature] Add an additional command line argument - "-format" to allow to output an expression instead of a singular version variable
• #3420 [Feature] Allow the default configuration file to have both yml and yaml extension
• #3661 Support Regex for label property
• !3742 Remove win-x86 support in BuildContext
• !3752 Add .net 8.0 support
• #1839 Configurable next-version strategies and mode
• #3453 [Feature] Same version computed on different branches
• #3877 Add configuration option to disable branch name version calculation
• #3922 [Feature] The increment of the branch will be ignored when prevent-increment is set to true on the branch
• #3461 [Feature] We need to consider somehow the IGitVersionConfiguration::Ignore property

Improvements

• #2316 [Improvement] Remove NoMono categories
• #3095 Change GitVersionInformation C# template ('const string' instead of 'static string')
• #3172 no-bump-message should take precedence over *-version-bump-message
• #3226 Feature/3101 rename config to configuration
• #3231 [Improvement] Switch to Central Package Management for nuget dependencies
• #3284 Fixed typo in image reference commit id
• #2193 [Improvement] Chocolatey package 'gitversion' should point to 'gitversion.portable'
• #3234 [Improvement] Rename the Cache namespace to Caching
• #3244 Refactor next version calculator (get rid of taggedSemanticVersion)
• #3334 [Improvement] Target .net6.0 and .net7.0 instead of netstandard2.0
• #3337 tracks-release-branches won't track remote release branches without regex mod
• #3375 [Improvement] Deprecate GitVersion.Commandline nuget package
• #3386 move build agents to a separate lib out of core
• #3398 Move output (VersionConverters) to its own module
• #2340 GitVersion should only consider tags matching current branch config (was: GitVersion fails to return correct version when tag exists on commit)
• #2742 [Improvement] Automatically update Docker Hub README with released version
• #3060 Cannot use empty tag in branch specific configuration
• #3245 Adds trouble shooting info for #1627
• #3443 [Improvement] The following classes needs to be changed to immutable types: SemanticVersion, SemanticVersionPreReleaseTag and SemanticVersionBuildMetaData
• #3454 Use IGitVersionConfiguration instead of GitVersionConfiguration (where possible)
• #2885 Improve GitVersion performance
• #3432 [Feature] Unknown language detected: 'wix'
• #3463 [Improvement] Update the CONTRIBUTING guidelines to match the current state of the code base
• #3479 Check that repository isn't a shallow clone and show an error if it is
• #3480 [Improvement] Rename back to "tag-pre-release-weight" and "tag-prefix"
• #3306 [Improvement] Move serialization and deserialization process of configuration out of the scope of core domain
• #3727 [Improvement] Include winget publishing in the release workflow
• !3768 Re-fixed github actions tag handling
• !3790 Extract GitVersion Configuration into a separate project
• !3804 Refactor GitVersion.Core for clear, maintainable methods
• !3806 Refactor variable serialization and extend serialization tests
• !3811 Switch to JSON for cache serialization and deserialization
• #3831 Better Bitbucket support for gitversion /output buildserver for Powershell
• !3844 Feature/replace the version mode mainline part i.a
• #3308 [Improvement] Replacing the mainline version mode with the continuous deployment mode
• !3921 Mark dependencies as private assets for GitVersion.MsBuild
• #3919 Review Ignored unit tests
• #3689 [Improvement] Increment version as per source branch
• #3916 [Improvement] Refator BaseVersionV2 into BaseVersion
• !3975 cleanups & refactorings
• !3984 Add support for Squash Commit releases
• #4000 [Improvement]: Rename TrunkBased Version Strategy to Mainline
• #4002 [Improvement]: Create TaggedSemanticVersionService class
• #4005 [Improvement]: Finalizing the configuration of GitFlow and GitHubFlow workflow and align with the Mainline version strategy
• !4087 Fix path separator for gitversion.dll in MSBuild task
• #4017 Verifies the contents of configuration.md against the default serialized configuration
• !4107 Sunset .net 7.0

SHA256 Hashes of the release artifacts

• 5fb42c20729a3a4c0ecb0b84a70d1f4a01b89f76d7e1bc39e0b86e3da7ccc868 - gitversion-linux-arm64-6.0.0.tar.gz
• a9654d447d9bc753c4c107efd726137a756b45249575ff7e2544b0dee34047df - gitversion-linux-musl-arm64-6.0.0.tar.gz
• 2be9d503181411b4443619675db3cd745fc42bfd11c620dd758f7b8d81960432 - gitversion-linux-musl-x64-6.0.0.tar.gz
• 99324ad86713606f2e5e81f77a3d034ae1c9b2bc8672ddc0ffcec5150e6e92b4 - gitversion-linux-x64-6.0.0.tar.gz
• 16d23f586181bc816587ab923a32504b5bf6451d11c86856b3929afd0527c09c - gitversion-osx-arm64-6.0.0.tar.gz
• f0c5fe2512d918acdea7cd145bff04729c6071f0ccee4bbdf04abcaa14daa219 - gitversion-osx-x64-6.0.0.tar.gz
• e9897532489586e276cf449aee66e141e675d226d43be12976d8495a8ae12e77 - gitversion-win-arm64-6.0.0.zip
• 5905dc372acecee526b6e29ee38853fa5f53b36db3812b2de9715f4da8644155 - gitversion-win-x64-6.0.0.zip