[GH-ISSUE #311] Change in behavior #4468

New Issue

GiteaMirror · 2026-06-13T12:33:05-05:00

GiteaMirror commented

2026-06-13 12:33:05 -05:00

Originally created by @tallesl on GitHub (Jun 7, 2016).
Original GitHub issue: https://github.com/semver/semver/issues/311

The spec is well defined when it comes to changing the API, take the following paragraph for instance:

Bug fixes not affecting the API increment the patch version, backwards compatible API additions/changes increment the minor version, and backwards incompatible API changes increment the major version.

Pretty straightforward.

But what about substantial behavioral changes? There are times that you make big changes in a code behavior without changing a thing on its API. Is that a patch?

Example 1

Suppose there's a library that sends emails. Let's say that on version 1.0.0 it simply sends emails as plain text, no configuration there.

On its second release the author changes the library to send emails as HTML instead, without changing anything on its API. It does that automatically. What's the version?

For the user that rely on the fact that it sends only plain text emails, that's a major (2.0.0). For the user that may be interested in sending emails with rich content now and doesn't bother with HTML being automatically assumed, that's a minor (1.1.0). For the user that expects semver to be solely about the API as the spec mentions it, that's a patch (1.0.1).

Example 2

Imagine a scheduling library for an object oriented language that accepts custom jobs designed by a user. The user gives the library the type of its job implementation and some cron-like scheduling.

On current version the library instantiates one single job object and calls it (the same object) every time its schedule is fired.

Now someone points out the fact that may be a better design to instantiate a new object for each time the scheduled is fired. The author of the library finds the argument convincing and changes the library, but no API change was needed.

If one uses the library only with stateless jobs that's a patch alright. But what if some of the library users were relying on the fact that it treated the jobs as singletons?

(this last example is a real scenario by the way)

Originally created by @tallesl on GitHub (Jun 7, 2016). Original GitHub issue: https://github.com/semver/semver/issues/311 The spec is well defined when it comes to changing the API, take the following paragraph for instance: > Bug fixes not affecting the API increment the patch version, backwards compatible API additions/changes increment the minor version, and backwards incompatible API changes increment the major version. Pretty straightforward. But what about substantial behavioral changes? There are times that you make big changes in a code behavior without changing a thing on its API. Is that a patch? **Example 1** Suppose there's a library that sends emails. Let's say that on version `1.0.0` it simply sends emails as plain text, no configuration there. On its second release the author changes the library to send emails as HTML instead, without changing anything on its API. It does that automatically. What's the version? For the user that rely on the fact that it sends only plain text emails, that's a major (`2.0.0`). For the user that may be interested in sending emails with rich content now and doesn't bother with HTML being automatically assumed, that's a minor (`1.1.0`). For the user that expects semver to be solely about the API as the spec mentions it, that's a patch (`1.0.1`). **Example 2** Imagine a scheduling library for an object oriented language that accepts custom jobs designed by a user. The user gives the library the type of its job implementation and some cron-like scheduling. On current version the library instantiates one single job object and calls it (the same object) every time its schedule is fired. Now someone points out the fact that may be a better design to instantiate a new object for each time the scheduled is fired. The author of the library finds the argument convincing and changes the library, but no API change was needed. If one uses the library only with stateless jobs that's a patch alright. But what if some of the library users were relying on the fact that it treated the jobs as singletons? ([this last example is a real scenario by the way](https://github.com/fluentscheduler/FluentScheduler/issues/82))

GiteaMirror closed this issue

2026-06-13 12:33:06 -05:00

GiteaMirror commented

2026-06-13 12:33:06 -05:00

@haacked commented on GitHub (Jun 7, 2016):

The behavior of an API is part of the API, not just the shape of the API. So in Example 1, I'd consider that a breaking change and increment the major version. Another way to look at it is that SemVer is about communicating intent and risk of breaking to consumers. If a large number of customers would consider it a breaking change, then you could increment the major.

For example, in Example 1, instead of replacing text with HTML, you used multi-part mime type to send an email as both, you could argue that's just a minor increment because existing emails continue to work as before and only those who opt-in to the HTML get HTML.

For example 2, I'd argue that it depends on whether the singleton behavior is explicitly called out as part of the design of the API. It seems to me that people are relying on an implementation detail if they assume the singleton. So I would not increment major unless I had strong data to indicate that changing this behavior would break a large number of my customers.

The reason is in general, consumers of an API should be discouraged from coupling to heavily to implementation details. For example, private reflection is a classic example. Every change to software has the potential to be a breaking change. People could be relying on timing of your code and a performance optimization could break their apps. But these are cases where perhaps they get what they deserve when a minor change breaks them.

I'll close this since there's nothing actionable here, but feel free to continue the discussion or reopen if the answer is not satisfactory. 😄

@haacked commented on GitHub (Jun 7, 2016): The behavior of an API is part of the API, not just the shape of the API. So in Example 1, I'd consider that a breaking change and increment the major version. Another way to look at it is that SemVer is about communicating intent and risk of breaking to consumers. If a large number of customers would consider it a breaking change, then you could increment the major. For example, in Example 1, instead of replacing text with HTML, you used multi-part mime type to send an email as both, you could argue that's just a minor increment because existing emails continue to work as before and only those who opt-in to the HTML get HTML. For example 2, I'd argue that it depends on whether the singleton behavior is explicitly called out as part of the design of the API. It seems to me that people are relying on an implementation detail if they assume the singleton. So I would not increment major unless I had strong data to indicate that changing this behavior would break a large number of my customers. The reason is in general, consumers of an API should be discouraged from coupling to heavily to implementation details. For example, private reflection is a classic example. Every change to software has the potential to be a breaking change. People could be relying on timing of your code and a performance optimization could break their apps. But these are cases where perhaps they get what they deserve when a minor change breaks them. I'll close this since there's nothing actionable here, but feel free to continue the discussion or reopen if the answer is not satisfactory. :smile:

GiteaMirror commented

2026-06-13 12:33:07 -05:00

@krzysiekpiasecki commented on GitHub (Jun 7, 2016):

But what about substantial behavioral changes? There are times that you make big changes in a code behavior without changing a thing on its API. Is that a patch?

From point 7:

It MAY be incremented if substantial new functionality or improvements are introduced within the private code.

Release as Minor.

@krzysiekpiasecki commented on GitHub (Jun 7, 2016): > But what about substantial behavioral changes? There are times that you make big changes in a code behavior without changing a thing on its API. Is that a patch? From point 7: > It MAY be incremented if substantial new functionality or improvements are introduced within the private code. Release as Minor.

GiteaMirror commented

2026-06-13 12:33:07 -05:00

@tallesl commented on GitHub (Jun 8, 2016):

@Haacked

I'm A-OK with most of the remarks you made, specially the last one on relying too much on implementation details.

The behavior of an API is part of the API, not just the shape of the API.

But I'll have to disagree with you here. I think you can use the term "API" loosely implying the code that is underneath it (as a synonym for "program" or "library"), but in a strict sense I wouldn't think so. An API It's an (application programming) interface!

Take Wikipedia's definition for instance:

An API expresses a software component in terms of its operations, inputs, outputs, and underlying types, defining functionalities that are independent of their respective implementations, which allows definitions and implementations to vary without compromising the interface.

There's a note on FAQ addressing this issue:

Use your best judgment. If you have a huge audience that will be drastically impacted by changing the behavior back to what the public API intended, then it may be best to perform a major version release, even though the fix could strictly be considered a patch release. Remember, Semantic Versioning is all about conveying meaning by how the version number changes. If these changes are important to your users, use the version number to inform them.

My point is that this remark is just too important to be left on FAQ. In my opinion, the summary and the introduction gives the impression that to come with a version number is just a matter of taking a look on the API.

@tallesl commented on GitHub (Jun 8, 2016): @Haacked I'm A-OK with most of the remarks you made, specially the last one on relying too much on implementation details. > The behavior of an API is part of the API, not just the shape of the API. But I'll have to disagree with you here. I think you can use the term "API" loosely implying the code that is underneath it (as a synonym for "program" or "library"), but in a strict sense I wouldn't think so. An API It's an (application programming) interface! Take [Wikipedia's definition](https://en.wikipedia.org/wiki/Application_programming_interface) for instance: > An API expresses a software component in terms of its operations, inputs, outputs, and underlying types, defining functionalities that are independent of their respective implementations, which allows definitions and implementations to vary without compromising the interface. There's a note on FAQ addressing this issue: > Use your best judgment. If you have a huge audience that will be drastically impacted by changing the behavior back to what the public API intended, then it may be best to perform a major version release, even though the fix could strictly be considered a patch release. Remember, Semantic Versioning is all about conveying meaning by how the version number changes. If these changes are important to your users, use the version number to inform them. My point is that this remark is just too important to be left on FAQ. In my opinion, the summary and the introduction gives the impression that to come with a version number is just a matter of taking a look on the API.

GiteaMirror commented

2026-06-13 12:33:08 -05:00

@FichteFoll commented on GitHub (Jun 8, 2016):

An API usually makes promises about what happens when you use it in a certain way (like arguments). If the API states in its documentation "sends an email" then changing the way the email is sent is not a breaking change to the API. If it states "sends a plaintext email" and you start sending multi-part mime, it becomes a breaking and major change.

@FichteFoll commented on GitHub (Jun 8, 2016): An API usually makes promises about what happens when you use it in a certain way (like arguments). If the API states in its documentation "sends an email" then changing the way the email is sent is not a breaking change to the API. If it states "sends a plaintext email" and you start sending multi-part mime, it becomes a breaking and major change.

GiteaMirror commented

2026-06-13 12:33:09 -05:00

@haacked commented on GitHub (Jun 8, 2016):

I should have been more precise. SemVer is typically used to version a package or library. If the behavior changes significantly, then you increment the major version of the library.

Your example with the singleton assumes an implementation as the change is in behavior and not the API. So I assumed your example really referred to a library because as you point out, an API is independent of an implementation so talking about a behavior change doesn't make sense in the context of the API.

In sum, if the API doesn't change, its version doesn't. But a specific implementation of it might version independently of the API it implements.

@haacked commented on GitHub (Jun 8, 2016): I should have been more precise. SemVer is typically used to version a package or library. If the behavior changes significantly, then you increment the major version of the library. Your example with the singleton assumes an implementation as the change is in behavior and not the API. So I assumed your example really referred to a library because as you point out, an API is independent of an implementation so talking about a behavior change doesn't make sense in the context of the API. In sum, if the API doesn't change, its version doesn't. But a specific implementation of it might version independently of the API it implements.

GiteaMirror commented

2026-06-13 12:33:09 -05:00

@tallesl commented on GitHub (Jun 8, 2016):

If the behavior changes significantly, then you increment the major version of the library.

Agreed.

In sum, if the API doesn't change, its version doesn't.

If there was no change in the API and no change in implementation, well, nothing changed. If there was no change in the API but there was a change in implementation you have to change the version, after all you have something to distribute here.

But a specific implementation of it might version independently of the API it implements.

I sincerely didn't get this one. Are you mentioning things like Java folks that creates packages that are only an API without any implementation at all?

I think we're starting to repeat ourselves here. I just want to end here saying that if you combine the definition of API

An API expresses a software component in terms of its operations, inputs, outputs, and underlying types, defining functionalities that are independent of their respective implementations

with what the spec says on its introduction

Bug fixes not affecting the API increment the patch version, backwards compatible API additions/changes increment the minor version, and backwards incompatible API changes increment the major version.

it gives the wrong impression what breakage really is (behavior is completely left out).

@tallesl commented on GitHub (Jun 8, 2016): > If the behavior changes significantly, then you increment the major version of the library. Agreed. > In sum, if the API doesn't change, its version doesn't. If there was no change in the API and no change in implementation, well, nothing changed. If there was no change in the API but there was a change in implementation you have to change the version, after all you have something to distribute here. > But a specific implementation of it might version independently of the API it implements. I sincerely didn't get this one. Are you mentioning things like [Java folks that creates packages that are only an API](http://www.slf4j.org/) without any implementation at all? --- I think we're starting to repeat ourselves here. I just want to end here saying that if you combine the definition of API > An API expresses a software component in terms of its operations, inputs, outputs, and underlying types, defining functionalities that are independent of their respective implementations with what the spec says on its introduction > Bug fixes not affecting the API increment the patch version, backwards compatible API additions/changes increment the minor version, and backwards incompatible API changes increment the major version. it gives the wrong impression what breakage really is (behavior is completely left out).

GiteaMirror commented

2026-06-13 12:33:09 -05:00

@crazedsanity commented on GitHub (Jun 8, 2016):

Well, look at it this way: how much does the implementor have to change when upgrading?

Consider it in simpler terms, from the perspective of the implementor (the developer that's actually utilizing the library in question):

PATCH: I can upgrade with no change to the code.
MINOR: There's some work to do, but nothing substantial
MAJOR: Plenty of code to change/refactor/rewrite

@crazedsanity commented on GitHub (Jun 8, 2016): Well, look at it this way: how much does the implementor have to change when upgrading? Consider it in simpler terms, from the perspective of the implementor (the developer that's actually utilizing the library in question): PATCH: I can upgrade with no change to the code. MINOR: There's some work to do, but nothing substantial MAJOR: Plenty of code to change/refactor/rewrite

GiteaMirror commented

2026-06-13 12:33:10 -05:00

@tallesl commented on GitHub (Jun 8, 2016):

@crazedsanity

By not using the word "API" you didn't step in the confusion I'm addressing in this issue. The spec on the other hand does use the word.

@tallesl commented on GitHub (Jun 8, 2016): @crazedsanity By not using the word "API" you didn't step in the confusion I'm addressing in this issue. The spec on the other hand does use the word.

GiteaMirror commented

2026-06-13 12:33:11 -05:00

@haacked commented on GitHub (Jun 8, 2016):

@tallesl I see your point. In the introduction to SemVer, it starts off by talking about packages.

The bigger your system grows and the more packages you integrate into your software, the more likely you are to find yourself, one day, in this pit of despair.

And then it moves into a discussion of the API without really defining API.

Major version X (X.y.z | X > 0) MUST be incremented if any backwards incompatible changes are introduced to the public API.

So if we strictly define API as just the "interface" a breaking change that doesn't change the interface wouldn't change the major version.

I never noticed this because I always read this as:

Major version X (X.y.z | X > 0) MUST be incremented if any backwards incompatible changes are introduced to the package.

So the question is, what's the best most minimal way to address this?

@haacked commented on GitHub (Jun 8, 2016): @tallesl I see your point. In the introduction to SemVer, it starts off by talking about packages. > The bigger your system grows and the more packages you integrate into your software, the more likely you are to find yourself, one day, in this pit of despair. And then it moves into a discussion of the API without really defining API. > Major version X (X.y.z | X > 0) MUST be incremented if any backwards incompatible changes are introduced to the public API. So if we strictly define API as just the "interface" a breaking change that doesn't change the interface wouldn't change the major version. I never noticed this because I always read this as: > Major version X (X.y.z | X > 0) MUST be incremented if any backwards incompatible changes are introduced to the **package**. So the question is, what's the best most minimal way to address this?

GiteaMirror commented

2026-06-13 12:33:14 -05:00

@tallesl commented on GitHub (Jun 8, 2016):

@Haacked

I think the best/most minimal way to address this is by adding a short statement on the introduction stating what we have been discussing here. I also would recommend to add it just after the quote that uses "API" to define what patch, minor and major is (that's the troublesome part IMO).

What about

This may consist of documentation or be enforced by the code itself. Regardless, it is important that this API be clear and precise. Once you identify your public API, you communicate changes to it with specific increments to your version number. Consider a version format of X.Y.Z (Major.Minor.Patch). Bug fixes not affecting the API increment the patch version, backwards compatible API additions/changes increment the minor version, and backwards incompatible API changes increment the major version. Also, use your best judgment, if you have an audience that may be impacted by a change in behavior of the API consider performing a major version release, even though could strictly be considered a patch release.

It's a slightly modified sentence from the FAQ.

@tallesl commented on GitHub (Jun 8, 2016): @Haacked I think the best/most minimal way to address this is by adding a short statement on the introduction stating what we have been discussing here. I also would recommend to add it just after the quote that uses "API" to define what patch, minor and major is (that's the troublesome part IMO). What about > This may consist of documentation or be enforced by the code itself. Regardless, it is important that this API be clear and precise. Once you identify your public API, you communicate changes to it with specific increments to your version number. Consider a version format of X.Y.Z (Major.Minor.Patch). Bug fixes not affecting the API increment the patch version, backwards compatible API additions/changes increment the minor version, and backwards incompatible API changes increment the major version. **Also, use your best judgment, if you have an audience that may be impacted by a change in behavior of the API consider performing a major version release, even though could strictly be considered a patch release.** It's a slightly modified sentence from the [FAQ](http://semver.org/#what-if-i-inadvertently-alter-the-public-api-in-a-way-that-is-not-compliant-with-the-version-number-change-ie-the-code-incorrectly-introduces-a-major-breaking-change-in-a-patch-release).

GiteaMirror commented

2026-06-13 12:33:16 -05:00

@haacked commented on GitHub (Jun 8, 2016):

I like it, but want to tweak it a bit. How about?

Keep in mind that the purpose of Semantic Versioning is to communicate the risk that a change will impact your audience. It's possible that a change to a package does not change the public API, but does change the behavior enough to break most consumers. In such a scenario, consider incrementing the major version even though it could strictly be considered a patch release if you looked only at the change to the API surface.

@haacked commented on GitHub (Jun 8, 2016): I like it, but want to tweak it a bit. How about? > Keep in mind that the purpose of Semantic Versioning is to communicate the risk that a change will impact your audience. It's possible that a change to a package does not change the public API, but does change the behavior enough to break most consumers. In such a scenario, consider incrementing the major version even though it could strictly be considered a patch release if you looked only at the change to the API surface.

GiteaMirror commented

2026-06-13 12:33:17 -05:00

@tallesl commented on GitHub (Jun 8, 2016):

Even better 👍

P.S.: Maybe that FAQ statement becomes redundant now that we "promoted" the remark to the introduction, even though they are not literally identical.

@tallesl commented on GitHub (Jun 8, 2016): Even better :+1: P.S.: Maybe that FAQ statement becomes redundant now that we "promoted" the remark to the introduction, even though they are not literally identical.

GiteaMirror commented

2026-06-13 12:33:17 -05:00

@krzysiekpiasecki commented on GitHub (Jun 8, 2016):

But what about substantial behavioral changes?
Suppose there's a library that sends emails. Let's say that on version 1.0.0 it simply sends emails as plain text, no configuration there.
On its second release the author changes the library to send emails as HTML instead, without changing anything on its API. It does that automatically. What's the version?

IMHO you have probably developed a new library function, so next release is 1.1.0 but you MUST still support the old function, which sends plain text until next MAJOR because of old clients. You can manifest also old function as deprecated if you want remove this function in a future with next MAJOR release.

@krzysiekpiasecki commented on GitHub (Jun 8, 2016): > > But what about substantial behavioral changes? > > Suppose there's a library that sends emails. Let's say that on version 1.0.0 it simply sends emails as plain text, no configuration there. > > On its second release the author changes the library to send emails as HTML instead, without changing anything on its API. It does that automatically. What's the version? IMHO you have probably developed a new library function, so next release is 1.1.0 but you MUST still support the old function, which sends plain text until next MAJOR because of old clients. You can manifest also old function as deprecated if you want remove this function in a future with next MAJOR release.

GiteaMirror commented

2026-06-13 12:33:18 -05:00

@israel-lugo commented on GitHub (Sep 20, 2016):

I would suggest that (the main?) part of the problem is with the term "API". It seems some people read it as "the sum of your program's public functions and their expected behavior", with "behavior" being left for a case-by-case analysis, whereas some people read "API" in the stricter sense of "Application Programmer Interface".

I've opened issue #331 for discussing precisely this matter. I believe "API" is too limiting and could be improved by replacing it e.g. with "Interface" or something that means "the full interaction with the program".

Yes, an introduction can be added, and a FAQ entry and so on, but perhaps if we find a better suited term, the extra explanations cease to be necessary.

@israel-lugo commented on GitHub (Sep 20, 2016): I would suggest that (the main?) part of the problem is with the term "API". It seems some people read it as "the sum of your program's public functions and their expected behavior", with "behavior" being left for a case-by-case analysis, whereas some people read "API" in the stricter sense of "Application Programmer Interface". I've opened issue #331 for discussing precisely this matter. I believe "API" is too limiting and could be improved by replacing it e.g. with "Interface" or something that means "the full interaction with the program". Yes, an introduction can be added, and a FAQ entry and so on, but perhaps if we find a better suited term, the extra explanations cease to be necessary.

GiteaMirror commented

2026-06-13 12:33:18 -05:00

@jwdonahue commented on GitHub (Oct 9, 2018):

Reference #468 for tracking.

@jwdonahue commented on GitHub (Oct 9, 2018): Reference #468 for tracking.

GiteaMirror commented

2026-06-13 12:33:19 -05:00

@danbirle commented on GitHub (Feb 12, 2021):

The behavior of an API is part of the API, not just the shape of the API. So in Example 1, I'd consider that a breaking change and increment the major version. Another way to look at it is that SemVer is about communicating intent and risk of breaking to consumers. If a large number of customers would consider it a breaking change, then you could increment the major.

can semver be used in frontend projects? we've been using it for a while now but some of us are torn when it comes to deciding what flag to use when we have a Visual Change? (you know.... designers decided that font looks better with font-weight: 100 in some places).

it doesn't break anything at all, can't be major
nothing's wrong, designers changed their mind, so we can't use patch as it's not really a bug, even if it looks different from our current mockups
inclined to say minor but that's only because it doesn't fit the other two at all, not because this is an "addition"

@danbirle commented on GitHub (Feb 12, 2021): > The behavior of an API is part of the API, not just the shape of the API. So in Example 1, I'd consider that a breaking change and increment the major version. Another way to look at it is that SemVer is about communicating intent and risk of breaking to consumers. If a large number of customers would consider it a breaking change, then you could increment the major. can semver be used in frontend projects? we've been using it for a while now but some of us are torn when it comes to deciding what flag to use when we have a Visual Change? (you know.... designers decided that font looks better with font-weight: 100 in some places). * it doesn't break anything at all, can't be major * nothing's wrong, designers changed their mind, so we can't use patch as it's not really a bug, even if it looks different from our current mockups * inclined to say minor but that's only because it doesn't fit the other two at all, not because this is an "addition"

GiteaMirror commented

2026-06-13 12:33:19 -05:00

@crazedsanity commented on GitHub (Feb 12, 2021):

I don't see and reason why you couldn't use it for frontend code. It's
likely different than backend code, so versioning is a little different.

I would suggest incrementing patch level, as it doesn't fit a major/minor
change. This basically just reflects that there was a change in the code,
but nothing too big.

Make sense?

On Fri, Feb 12, 2021, 6:30 AM 'Razvan Dan Birle' via github <
github@crazedsanity.com> wrote:

The behavior of an API is part of the API, not just the shape of the API.
So in Example 1, I'd consider that a breaking change and increment the
major version. Another way to look at it is that SemVer is about
communicating intent and risk of breaking to consumers. If a large number
of customers would consider it a breaking change, then you could increment
the major.

can semver be used in frontend projects? we've been using it for a while
now but some of us are torn when it comes to deciding what flag to use when
we have a Visual Change? (you know.... designers decided that font looks
better with font-weight: 100 in some places).

it doesn't break anything at all, can't be major

nothing's wrong, designers changed their mind, so we can't use patch
as it's not really a bug, even if it looks different from our current
mockups

inclined to say minor but that's only because it doesn't fit the
other two at all, not because this is an "addition"

—
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHub
https://github.com/semver/semver/issues/311#issuecomment-778167853, or
unsubscribe
https://github.com/notifications/unsubscribe-auth/AALL7TWX66LQPTBLSMZN2D3S6UNN3ANCNFSM4CGBTSGQ
.

@crazedsanity commented on GitHub (Feb 12, 2021): I don't see and reason why you couldn't use it for frontend code. It's likely different than backend code, so versioning is a little different. I would suggest incrementing patch level, as it doesn't fit a major/minor change. This basically just reflects that there was a change in the code, but nothing too big. Make sense? On Fri, Feb 12, 2021, 6:30 AM 'Razvan Dan Birle' via github < github@crazedsanity.com> wrote: > The behavior of an API is part of the API, not just the shape of the API. > So in Example 1, I'd consider that a breaking change and increment the > major version. Another way to look at it is that SemVer is about > communicating intent and risk of breaking to consumers. If a large number > of customers would consider it a breaking change, then you could increment > the major. > > can semver be used in frontend projects? we've been using it for a while > now but some of us are torn when it comes to deciding what flag to use when > we have a Visual Change? (you know.... designers decided that font looks > better with font-weight: 100 in some places). > > - it doesn't break anything at all, can't be major > - nothing's wrong, designers changed their mind, so we can't use patch > as it's not really a bug, even if it looks different from our current > mockups > - inclined to say minor but that's only because it doesn't fit the > other two at all, not because this is an "addition" > > — > You are receiving this because you were mentioned. > Reply to this email directly, view it on GitHub > <https://github.com/semver/semver/issues/311#issuecomment-778167853>, or > unsubscribe > <https://github.com/notifications/unsubscribe-auth/AALL7TWX66LQPTBLSMZN2D3S6UNN3ANCNFSM4CGBTSGQ> > . >

GiteaMirror commented

2026-06-13 12:33:19 -05:00

@haacked commented on GitHub (Feb 12, 2021):

You can certainly use it for frontend projects. However keep in mind what the purpose of SemVer is. Its primary goal is to help people to evaluate the risk of upgrading a dependency to a new version. This is particularly important with libraries/packages. If a library publishes a new major version, upgrading to that new major version could break every system that depends on it.

With a front-end project, you want to evaluate the dependencies. If your project is not a dependency to other systems, then the version doesn't serve much person other than to communicate the amount of change that occurred. It's more a marketing version than a technical version.

If others depend on your project, then the version matters more because it can communicate how much work it will be to upgrade.

With that framing in mind, let's go back to your question. As @crazedsanity noted, if you change the font, there's probably 0 risk to upgrading to the new version. In that case, incrementing Patch makes sense. Minor version would make sense if the visual change introduces a new capability that wasn't there before. Major version would indicate that the visual change may break people's existing workflows (maybe you removed a feature).

Hope that helps.

@haacked commented on GitHub (Feb 12, 2021): You can certainly use it for frontend projects. However keep in mind what the purpose of SemVer is. Its primary goal is to help people to evaluate the risk of upgrading a dependency to a new version. This is particularly important with libraries/packages. If a library publishes a new major version, upgrading to that new major version could break every system that depends on it. With a front-end project, you want to evaluate the dependencies. If your project is not a dependency to other systems, then the version doesn't serve much person other than to communicate the amount of change that occurred. It's more a marketing version than a technical version. If others depend on your project, then the version matters more because it can communicate how much work it will be to upgrade. With that framing in mind, let's go back to your question. As @crazedsanity noted, if you change the font, there's probably 0 risk to upgrading to the new version. In that case, incrementing Patch makes sense. Minor version would make sense if the visual change introduces a new capability that wasn't there before. Major version would indicate that the visual change may break people's existing workflows (maybe you removed a feature). Hope that helps.

GiteaMirror commented

2026-06-13 12:33:20 -05:00

@danbirle commented on GitHub (Feb 15, 2021):

I would suggest incrementing patch level, as it doesn't fit a major/minor change. This basically just reflects that there was a change in the code, but nothing too big. Make sense?

Makes sense, I'll go with this approach. Thank you both!

@danbirle commented on GitHub (Feb 15, 2021): > I would suggest incrementing patch level, as it doesn't fit a major/minor change. This basically just reflects that there was a change in the code, but nothing too big. Make sense? Makes sense, I'll go with this approach. Thank you both!

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github-starred/semver#4468