Skip to content

Fixes #14366 - Clarify Deprecation Policy.#14369

Merged
sbordet merged 2 commits into
jetty-12.1.xfrom
fix/jetty-12.1.x/14366-clarify-deprecation-policy
Mar 3, 2026
Merged

Fixes #14366 - Clarify Deprecation Policy.#14369
sbordet merged 2 commits into
jetty-12.1.xfrom
fix/jetty-12.1.x/14366-clarify-deprecation-policy

Conversation

@sbordet

@sbordet sbordet commented Jan 21, 2026

Copy link
Copy Markdown
Contributor

Updated wording to be clearer.

Updated wording to be clearer.

Signed-off-by: Simone Bordet <simone.bordet@gmail.com>
@sbordet sbordet self-assigned this Jan 21, 2026
@sbordet sbordet moved this to 👀 In review in Jetty 12.1.6 - FROZEN Jan 21, 2026
@sbordet sbordet linked an issue Jan 21, 2026 that may be closed by this pull request
lorban
lorban previously approved these changes Jan 21, 2026
joakime
joakime previously approved these changes Jan 21, 2026
Comment thread documentation/jetty/modules/programming-guide/pages/index.adoc Outdated
@lachlan-roberts

Copy link
Copy Markdown
Member

I think this is a really bad idea for us to allow removal of deprecated code for micro releases.

It contradicts the widely accepted industry practice where micro/patch releases are expected to be non-breaking.

I would instead be in favor of this policy:

  • major release (x.y.z -> (x+1).0.0) - deprecation removal is allowed without restriction.
  • minor release (x.y.z -> x.(y+1).0) - deprecation removal is allowed subject to the 6+ micro release condition.
  • micro release (x.y.z -> x.y.(z+1)) - deprecation removal is not allowed.

This way users who are updating micro releases have some assurance of backward compatibility across micro releases. And they're not encouraged to just pin their applications to a specific micro release to avoid potential breaking changes.

Signed-off-by: Simone Bordet <simone.bordet@gmail.com>
@sbordet sbordet dismissed stale reviews from joakime and lorban via da1a137 March 3, 2026 09:04
@sbordet sbordet merged commit fa1f400 into jetty-12.1.x Mar 3, 2026
7 of 9 checks passed
@github-project-automation github-project-automation Bot moved this from 👀 In review to ✅ Done in Jetty 12.1.7 FROZEN Mar 3, 2026
@sbordet sbordet deleted the fix/jetty-12.1.x/14366-clarify-deprecation-policy branch March 3, 2026 14:56
sbordet added a commit that referenced this pull request Mar 6, 2026
* Updated deprecation policy to follow the consensus after discussions.

Signed-off-by: Simone Bordet <simone.bordet@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

No open projects
Status: ✅ Done

Development

Successfully merging this pull request may close these issues.

Clarify Deprecation Policy

4 participants