Skip to content

Conversation

@adambkaplan
Copy link
Member

@adambkaplan adambkaplan commented Jan 12, 2026

Changes

This change proposes to merge the rejected and withdrawn
phases with a declined phase. This phase preserves the intent
of a feature that the community decided to not implement. To
communicate how the lifecycle works, a MermaidJS flowchart has
been added, and the markdown content has been restructured to
include sub-headers.

The replaced state has also been updated to communicate that
a specific feature has been deprecated or removed. Deprecations
and removals require SHIP proposals to ensure the end community
is well informed and has sufficient time to stop using the given
functionality.

Finally, this change also adds a requirement that implementable
proposals should create corresponding feature tracker issues
in GitHub, with sub-issues that identify specific tasks that
implement the feature. Tracker issues broadcast to the community
work that needs to be done and document the progress of a feature.
These tracker issues also encourage contributions from new
community members.

/kind feature

Submitter Checklist

  • Includes tests if functionality changed/was added
  • Includes docs if changes are user-facing
  • Set a kind label on this PR
  • Release notes block has been filled in, or marked NONE

See the contributor guide
for details on coding conventions, github and prow interactions, and the code review process.

Release Notes

Simplify SHIP lifecycle with `declined` status, and document process for broadcasting implementable feature work to the community.

@openshift-ci openshift-ci bot added the kind/documentation Categorizes issue or PR as related to documentation. label Jan 12, 2026
@pull-request-size pull-request-size bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Jan 12, 2026
@pull-request-size pull-request-size bot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. and removed size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Jan 12, 2026
This change proposes to merge the `rejected` and `withdrawn`
phases with a `declined` phase. This phase preserves the intent
of a feature that the community decided to not implement. To
communicate how the lifecycle works, a MermaidJS flowchart has
been added, and the markdown content has been restructured to
include sub-headers.

The `replaced` state has also been updated to communicate that
a specific feature has been deprecated or removed. Deprecations
and removals require SHIP proposals to ensure the end community
is well informed and has sufficient time to stop using the given
functionality.

Finally, this change also adds a requirement that `implementable`
proposals should create corresponding feature tracker issues
in GitHub, with sub-issues that identify specific tasks that
implement the feature. Tracker issues broadcast to the community
work that needs to be done and document the progress of a feature.
These tracker issues also encourage contributions from new
community members.

Assisted-by: Cursor
Signed-off-by: Adam Kaplan <adam.kaplan@redhat.com>
@adambkaplan adambkaplan force-pushed the ship-lifecycle-update branch from 286535d to 199022f Compare January 12, 2026 16:27
@adambkaplan adambkaplan changed the title fix: Clarify SHIP Lifecycle feat: Clarify and Simplify SHIP Lifecycle Jan 12, 2026
@sayan-biswas
Copy link

/approve

@adambkaplan
Copy link
Member Author

/approve

Self-approving

@openshift-ci
Copy link

openshift-ci bot commented Jan 26, 2026

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: adambkaplan, sayan-biswas

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@openshift-ci openshift-ci bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Jan 26, 2026
@adambkaplan
Copy link
Member Author

Considering' @sayan-biswas 's comment an "LGTM", merging by lazy consensus.

@adambkaplan adambkaplan merged commit 8150e14 into shipwright-io:main Jan 26, 2026
1 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. kind/documentation Categorizes issue or PR as related to documentation. size/M Denotes a PR that changes 30-99 lines, ignoring generated files.

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants