github.com/containers/podman/v5@v5.1.0-rc1/ISSUE-EOL-POLICY.md (about) 1 # End-of-Life Policy on Issues 2 3 _jetsam (n): the part of a ship, its equipment, or its cargo that is cast overboard to lighten the load in time of distress_ 4 5 Finite resources demand some level of pruning. This document describes 6 the basic principles used by the Containers team to identify and close 7 stale issues. 8 9 ------ 10 11 ## Definitions 12 13 [**stale**](https://github.com/containers/podman/issues?q=is%3Aopen+is%3Aissue+sort%3Acreated-asc+label%3Astale-issue): open, but no activity in the last thirty days. 14 15 **crickets**: closed due to lack of response from reporting party. 16 17 [**jetsam**](https://github.com/containers/podman/issues?q=is%3Aissue+label%3Ajetsam+is%3Aclosed): closed without being implemented. A deliberate decision made in recognition of human limitations. 18 19 ------ 20 21 ## Process 22 23 In order of judgment, from least to most. 24 25 #### → stale 26 27 Issues are marked with the label *stale-issue* by a [github action](https://github.com/containers/podman/blob/main/.github/workflows/stale.yml) that runs daily at 00:00 UT. This also triggers an email alert to subscribers on that issue. 28 29 Judgment: typically a team member will skim the issue, then decide whether to: 30 31 * remove the label; or 32 * close the issue (see below); or 33 * do nothing. 34 35 This is informal: there is no guarantee that anyone will actually do this. 36 37 #### → crickets 38 39 Typically done by a team member after receiving a *stale-issue* email. 40 41 Judgment: 42 43 * there is not enough information to act on the issue; and 44 * someone on the team has asked the reporter for more details (like NEEDINFO); and 45 * the reporter has not responded. 46 47 There is no actual *crickets* label. There is no automated way to 48 find issues that have been closed for this reason. 49 50 #### → jetsam 51 52 Last-resort closing of an issue that will not be worked on. 53 54 Factors: 55 56 * issue has remained open for over sixty days; and 57 * reporter is responsive, and still wishes to have the issue addressed (as does the team). 58 59 Judgment: 60 61 * the issue is too difficult or complicated or hard to track down. 62 * decision should be made by two or more team members, with discussion in the issue/PR itself. 63 64 When such an issue is closed, team member should apply the *jetsam* label. 65 66 ------ 67 68 ## Grayer Areas 69 70 `stalebot` isn't perfect. It often misses issues, and we end up with 71 some that have been open a long time and do not have the `stale-issue` label. 72 73 These are hard to find manually. There is no defined process for identifying 74 or acting on them. If and when someone finds these, they should be handled 75 through the process defined above.