Skip to content

Commit a8086d0

Browse files
authored
docs: feature-freeze unmaintained components (open-telemetry#2272)
* docs: impose feature-freeze on unmtainainted components * fixup! docs: impose feature-freeze on unmtainainted components * docs: add exemption for semconv updates * docs: clarify that bugs are exempt from auto-close * fixup! docs: clarify that bugs are exempt from auto-close * fixup! docs: impose feature-freeze on unmtainainted components
1 parent c361548 commit a8086d0

File tree

3 files changed

+43
-3
lines changed

3 files changed

+43
-3
lines changed

.github/component-label-map.yml

+9
Original file line numberDiff line numberDiff line change
@@ -270,3 +270,12 @@ pkg:sql-common:
270270
- changed-files:
271271
- any-glob-to-any-file:
272272
- packages/opentelemetry-sql-common/**
273+
pkg-status:unmaintained:
274+
- changed-files:
275+
- any-glob-to-any-file:
276+
- detectors/node/opentelemetry-resource-detector-github/**
277+
- plugins/node/opentelemetry-instrumentation-connect/**
278+
- plugins/node/opentelemetry-instrumentation-dns/**
279+
- plugins/node/opentelemetry-instrumentation-hapi/**
280+
- plugins/node/opentelemetry-instrumentation-koa/**
281+
- propagators/opentelemetry-propagator-ot-trace/**

.github/workflows/close-stale.yml

+21-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
name: 'Close stale issues and PRs'
22
on:
33
schedule:
4-
- cron: '30 6 * * 1'
4+
- cron: '30 6 * * *'
55

66
jobs:
77
stale:
@@ -20,3 +20,23 @@ jobs:
2020
exempt-issue-labels: never-stale
2121
exempt-pr-labels: never-stale
2222
any-of-labels: information-requested
23+
- uses: actions/stale@v9
24+
with:
25+
days-before-issue-stale: 0
26+
days-before-issue-close: 14
27+
stale-issue-message: 'This package does not have an assigned [component owner](https://github.com/open-telemetry/opentelemetry-js-contrib/blob/main/CONTRIBUTING.md#component-ownership) and is considered [unmaintained](https://github.com/open-telemetry/opentelemetry-js-contrib/blob/main/CONTRIBUTING.md#unmaintained). As such this package is in feature-freeze and this issue will be closed with 14 days unless a new owner or a sponsor (a member of @open-telemetry/javascript-approvers) for the feature is found. It is the responsibility of the author to find a sponsor for this feature.
28+
29+
Are you familiar with this package? Consider [becoming a component owner](https://github.com/open-telemetry/opentelemetry-js-contrib/blob/main/CONTRIBUTING.md#becoming-a-component-owner).'
30+
close-issue-message: 'This issue was closed because no owner or sponsor has been found after 14 days'
31+
only-labels: pkg-status:unmaintained,feature-request
32+
exempt-issue-labels: bug,has:sponsor,type:semconv-update
33+
- uses: actions/stale@v9
34+
with:
35+
days-before-pr-stale: 0
36+
days-before-pr-close: 14
37+
stale-pr-message: 'This package does not have an assigned [component owner](https://github.com/open-telemetry/opentelemetry-js-contrib/blob/main/CONTRIBUTING.md#component-ownership) and is considered [unmaintained](https://github.com/open-telemetry/opentelemetry-js-contrib/blob/main/CONTRIBUTING.md#unmaintained). As such this package is in feature-freeze and this PR will be closed with 14 days unless a new owner or a sponsor (a member of @open-telemetry/javascript-approvers) for the feature is found. It is the responsibility of the author to find a sponsor for this feature.
38+
39+
Are you familiar with this package? Consider [becoming a component owner](https://github.com/open-telemetry/opentelemetry-js-contrib/blob/main/CONTRIBUTING.md#becoming-a-component-owner).'
40+
close-pr-message: 'This issue was closed because no owner or sponsor has been found after 14 days'
41+
only-labels: pkg-status:unmaintained
42+
exempt-pr-labels: bug,has:sponsor,type:semconv-update

CONTRIBUTING.md

+13-2
Original file line numberDiff line numberDiff line change
@@ -222,8 +222,19 @@ Stable components MUST have their major version set to `1` or greater.
222222

223223
### Unmaintained
224224

225-
A component which does not have an assigned component owner, or has a component owner who has been unresponsive to issues and pull requests may be marked as unmaintained.
226-
Unmaintained components may continue to work and receive updates and fixes from contributors, but may not receive immediate attention if there is a problem or feature request.
225+
A component which does not have an assigned component owner, or has a component owner who has been unresponsive to issues
226+
and pull requests may be marked as `pkg-status:unmaintained`.
227+
228+
Unmaintained components may continue to work and receive updates and fixes from contributors. An unmaintained component
229+
is considered feature-freeze and new feature-requests may be closed within two weeks if no new owner is found.
230+
[@open-telemetry/javascript-approvers](https://github.com/orgs/open-telemetry/teams/javascript-approvers) may sponsor
231+
features for unmaintained components. At least one sponsor is needed to lift the feature-freeze for the purpose of
232+
adding the requested feature. Sponsors are expected to provide reviews for that feature and be responsive on the issue.
233+
234+
Components marked as unmaintained still receive semantic conventions updates and bugfixes where possible.
235+
[@open-telemetry/javascript-triagers](https://github.com/orgs/open-telemetry/teams/javascript-triagers) may add the
236+
`type:semconv-update` or `bug` label to mark them as exempt from being auto-closed within two weeks.
237+
227238
A component which is unmaintained may be deprecated if there is a problem that is not fixed in a timely manner.
228239

229240
### Deprecated

0 commit comments

Comments
 (0)