About ordering (seems that's becoming my speciality :))

Since it is not strictly a bug, I’m opening an issue here. The semver specification explicitly states that:

“Build metadata SHOULD be ignored when determining version precedence. Thus two versions that differ only in the build metadata, have the same precedence. Examples: 1.0.0-alpha+001, 1.0.0+20130313144700, 1.0.0-beta+exp.sha.5114f85.”

However, the Build metadata is actually considered in CompareTo method:

    public int CompareTo(SemVersion other)
    {
        if (ReferenceEquals(other, null))
            return 1;

        var r = this.CompareByPrecedence(other);
        if (r != 0)
            return r;

        r = CompareComponent(this.Build, other.Build);
        return r;
    }

Up to me, it should only be:

    public int CompareTo(SemVersion other)
    {
        if (ReferenceEquals(other, null))
            return 1;

        return CompareByPrecedence(other);
    }

[olivier-spinelli]

That’s exactly my point: semantically, the Build does not participate at all (It is a “decoration”): I would ignore it in CompareTo as well as in Equal (and document this of course).

[WalkerCodeRanger]

In v2.2.0, the CompareTo method has been marked [Obsolete]. It has been replaced by a CompareSortOrderTo and ComparePrecedenceTo method so that it will always be clear how the versions are being compared.