[GH-ISSUE #25] FAQ typo: bugfix is patch-, not minor-level #1752

New Issue

GiteaMirror · 2026-04-20T09:18:53-05:00

GiteaMirror commented

2026-04-20 09:18:53 -05:00

Originally created by @patcon on GitHub (May 17, 2012).
Original GitHub issue: https://github.com/semver/semver/issues/25

What should I do if I update my own dependencies without changing the public API?

[...] Determining whether the change is a patch level or minor level modification depends on whether you updated your dependencies in order to fix a bug or introduce new functionality. I would usually expect additional code for the latter instance, in which case it's obviously a minor level increment.

If you'd expect additional code for the latter (new functionality), isn't the former bug fix option a patch level, not a minor level, increment?

Originally created by @patcon on GitHub (May 17, 2012). Original GitHub issue: https://github.com/semver/semver/issues/25 > ### What should I do if I update my own dependencies without changing the public API? > > [...] Determining whether the change is a patch level or minor level modification depends on whether you updated your dependencies in order to **fix a bug or introduce new functionality**. I would usually expect additional code for the **latter** instance, in which case it's obviously a **minor level** increment. If you'd expect additional code for the latter (new functionality), isn't the former bug fix option a **patch level**, not a minor level, increment?

GiteaMirror closed this issue

2026-04-20 09:18:53 -05:00

GiteaMirror commented

2026-04-20 09:18:55 -05:00

@ayust commented on GitHub (Jun 7, 2012):

Yes, and that's what the document as written implies. The latter (new functionality) is a minor level increment. Nothing in your quote states that a bugfix is minor level.

@ayust commented on GitHub (Jun 7, 2012): Yes, and that's what the document as written implies. The _latter_ (new functionality) is a minor level increment. Nothing in your quote states that a bugfix is minor level.

GiteaMirror commented

2026-04-20 09:18:55 -05:00

@patcon commented on GitHub (Jun 7, 2012):

Oh good lord. I'm trying to understand how I was comprehending that before, and I can't really see it now. Oy. I think my brain was thinking that speaking in former-latter terminology means a juxtaposition is being formed. Sorry.

Might suggest this for dolts like me:

I would usually expect additional code for the latter instance, in which case that's obviously a minor level increment.

@patcon commented on GitHub (Jun 7, 2012): Oh good lord. I'm trying to understand how I was comprehending that before, and I can't really see it now. Oy. I think my brain was thinking that speaking in former-latter terminology means a juxtaposition is being formed. Sorry. Might suggest this for dolts like me: > I would usually expect additional code for the latter instance, in which case **that's** obviously a minor level increment.

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github-starred/semver#1752