what is the recommended way to handle deprecations? #195

Open
opened 2026-02-17 11:53:05 -06:00 by GiteaMirror · 2 comments
Owner

Originally created by @bshaffer on GitHub (Dec 20, 2023).

I assume since it's neither a feat or a fix, the recommended way to handle deprecations would be chore(deprecation): or simply chore: deprecate such and such. But would a deprecated: tag or deprecation: tag also make sense? Curious if anyone has any thoughts on this.

Originally created by @bshaffer on GitHub (Dec 20, 2023). I assume since it's neither a feat or a fix, the recommended way to handle deprecations would be `chore(deprecation):` or simply `chore: deprecate such and such`. But would a `deprecated:` tag or `deprecation:` tag also make sense? Curious if anyone has any thoughts on this.
Author
Owner

@javier-godoy commented on GitHub (Jan 2, 2024):

My colleagues use deprecate: We don't like using feat: because we reserve it for introducing new features, and we don't like chore: either, because it doesn't convey a Semantic Versioning level. However, many guidelines based on conventional commits don't specify a type for deprecations.

@javier-godoy commented on GitHub (Jan 2, 2024): My colleagues use `deprecate:` We don't like using `feat:` because we reserve it for _introducing new_ features, and we don't like `chore:` either, because it doesn't convey a Semantic Versioning level. However, many guidelines based on conventional commits don't specify a type for deprecations.
Author
Owner

@ph-One commented on GitHub (Jan 18, 2024):

Thoughts on feat(deprecate): Deprecate {{ thing }}? This would generate a feature release (as I would expect from a deprecation). One other option would be to use chore!: Deprecate {{ thing }}, but this equates to a MAJOR version change, which doesn't exactly feel right in all cases, especially since deprecation isn't truly a breaking change, just the first step in a breaking change. 🤷‍♂️

I'm here for the suggestions, as this feels like a common action that isn't called out in the spec.

@ph-One commented on GitHub (Jan 18, 2024): Thoughts on `feat(deprecate): Deprecate {{ thing }}`? This would generate a feature release (as I would expect from a deprecation). One other option would be to use `chore!: Deprecate {{ thing }}`, but this equates to a MAJOR version change, which doesn't exactly feel right in all cases, especially since deprecation isn't truly a breaking change, just the first step in a breaking change. :man_shrugging: I'm here for the suggestions, as this feels like a common action that isn't called out in the spec.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/conventionalcommits.org#195