Skip to content

Commit f52ee81

Browse files
authored
Add Issue Lifecycle and update Contributing (#81)
1 parent ef9bc9e commit f52ee81

File tree

2 files changed

+53
-6
lines changed

2 files changed

+53
-6
lines changed

CONTRIBUTING.md

Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -13,15 +13,19 @@ The following is a set of guidelines for contributing to the NGINX Ingress Opera
1313
[Style Guides](#style-guides)
1414
* [Git Style Guide](#git-style-guide)
1515

16-
[Code of Conduct](https://github.com/nginxinc/nginx-ingress-helm-operator/blob/main/CODE_OF_CONDUCT.md)
16+
[Code of Conduct](CODE_OF_CONDUCT.md)
1717

1818
## Ask a Question
1919

20-
Please open an Issue on GitHub with the label `question`.
20+
To ask a question please use [Github Discussions](https://github.com/nginxinc/kubernetes-ingress/discussions).
21+
22+
You can also join our [Community Slack](https://community.nginx.org/joinslack) which has a wider NGINX audience.
23+
24+
Please reserve GitHub issues for feature requests and bugs rather than general questions.
2125

2226
## Getting Started
2327

24-
Follow our [Installation Guide](https://github.com/nginxinc/nginx-ingress-helm-operator/blob/main/docs/installation.md) to get the NGINX Ingress Operator up and running.
28+
Follow our [Installation Guide](docs/installation.md) to get the NGINX Ingress Operator up and running.
2529

2630
Read the [documentation](https://github.com/nginxinc/nginx-ingress-helm-operator/tree/main/docs) .
2731

@@ -42,16 +46,22 @@ To suggest an enhancement, please create an issue on GitHub with the label `enha
4246
### Open a Pull Request
4347

4448
* Fork the repo, create a branch, submit a PR when your changes are tested and ready for review
45-
* Fill in [our pull request template](https://github.com/nginxinc/nginx-ingress-helm-operator/blob/main/.github/PULL_REQUEST_TEMPLATE.md)
49+
* Fill in [our pull request template](.github/PULL_REQUEST_TEMPLATE.md)
50+
51+
> **Note**
52+
>
53+
> If you’d like to implement a new feature, please consider creating a feature request issue first to start a discussion about the feature.
54+
55+
### Issue lifecycle
4656

47-
Note: if you’d like to implement a new feature, please consider creating a feature request issue first to start a discussion about the feature.
57+
* When an issue or PR is created, it will be triaged by the core development team and assigned a label to indicate the type of issue it is (bug, feature request, etc) and to determine the milestone. Please see the [Issue Lifecycle](ISSUE_LIFECYCLE.md) document for more information.
4858

4959
## Style Guides
5060

5161
### Git Style Guide
5262

5363
* Keep a clean, concise and meaningful git commit history on your branch, rebasing locally and squashing before submitting a PR
54-
* Follow the guidelines of writing a good commit message as described here https://chris.beams.io/posts/git-commit/ and summarised in the next few points
64+
* Follow the guidelines of writing a good commit message as described here https://chris.beams.io/posts/git-commit/ and summarized in the next few points
5565
* In the subject line, use the present tense ("Add feature" not "Added feature")
5666
* In the subject line, use the imperative mood ("Move cursor to..." not "Moves cursor to...")
5767
* Limit the subject line to 72 characters or less

ISSUE_LIFECYCLE.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
# Issue Lifecycle
2+
3+
To ensure a balance between work carried out by the NGINX engineering team while encouraging community involvement on this project, we use the following issue lifecycle. (Note: The issue *creator* refers to the community member that created the issue. The issue *owner* refers to the NGINX team member that is responsible for managing the issue lifecycle.)
4+
5+
1. New issue created by community member.
6+
7+
8+
2. Assign issue owner: All new issues are assigned an owner on the NGINX engineering team. This owner shepherds the issue through the subsequent stages in the issue lifecycle.
9+
10+
11+
3. Determine issue type: This is done with automation where possible, and manually by the owner where necessary. The associated label is applied to the issue.
12+
#### Possible Issue Types
13+
`needs more info`: The owner should use the issue to request information from the creator. If we don't receive the needed information within 7 days, automation closes the issue.
14+
15+
`bug`: The implementation of a feature is not correct.
16+
17+
`proposal`: Request for a change. This can be a new feature, tackling technical debt, documentation changes, or improving existing features.
18+
19+
`question`: The owner converts the issue to a github discussion and engages the creator.
20+
21+
22+
4. Determine milestone: The owner, in collaboration with the wider team (PM & engineering), determines what milestone to attach to an issue. Generally, milestones correspond to product releases - however there are two 'magic' milestones with special meanings (not tied to a specific release):
23+
24+
- Issues assigned to backlog: Our team is in favour of implementing the feature request/fixing the issue, however the implementation is not yet assigned to a concrete release. If and when a `backlog` issue aligns well with our roadmap, it will be scheduled for a concrete iteration. We review and update our roadmap at least once every quarter. The `backlog` list helps us shape our roadmap, but it is not the only source of input. Therefore, some `backlog` items may eventually be closed as `out of scope`, or relabelled as `backlog candidate` once it becomes clear that they do not align with our evolving roadmap.
25+
26+
- Issues assigned to `backlog candidate`: Our team does not intend to implement the feature/fix request described in the issue and wants the community to weigh in before we make our final decision.
27+
28+
`backlog` issues can be labeled by the owner as `help wanted` and/or `good first issue` as appropriate.
29+
30+
31+
5. Promotion of `backlog candidate` issue to `backlog` issue: If an issue labelled `backlog candidate` receives more than 30 upvotes within 60 days, we promote the issue by applying the `backlog` label. While issues promoted in this manner have not been committed to a particular release, we welcome PRs from the community on them.
32+
33+
If an issue does not make our roadmap and has not been moved to a discussion, it is closed with the label `out of scope`. The goal is to get every issue in the issues list to one of the following end states:
34+
35+
- An assigned release.
36+
- The `backlog` label.
37+
- Closed as `out of scope`.

0 commit comments

Comments
 (0)