Skip to content

Commit ecc4e50

Browse files
authored
- adds documentation for issues automation (#3454)
* - adds documentation for issues automation * - moves the automation processes to a different section - adds labels descriptions Signed-off-by: Vincent Biret <[email protected]> * - removes diagram * - adds clarification to when labels are added removed --------- Signed-off-by: Vincent Biret <[email protected]>
1 parent 6458d30 commit ecc4e50

File tree

1 file changed

+17
-1
lines changed

1 file changed

+17
-1
lines changed

DEVELOPMENT.md

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ The specification *will evolve over time*. Changes may be made when any of the
2424

2525
For each change in the specification we should *always* consider the following:
2626

27-
* Migration. Is this a construct that has a path from the [existing specification](https://github.com/OAI/OpenAPI-Specification/releases))? If so, how complicated is it to migrate to the proposed change?
27+
* Migration. Is this a construct that has a path from the [existing specification](https://github.com/OAI/OpenAPI-Specification/releases)? If so, how complicated is it to migrate to the proposed change?
2828

2929
* Tooling. Strive to support code generation, software interfaces, spec generation techniques, as well as other utilities. Some features may be impossible to support in different frameworks/languages. These should be documented and considered during the change approval process.
3030

@@ -101,6 +101,22 @@ However, where a new feature can be introduced in this way, it should be.
101101

102102
The process should be as transparent as possible. Sometimes there will be discussions that use customer names, sensitive use cases, and so on. These must be anonymized, discussed in a private repository, or conducted offline. General discussions should happen on the GitHub issues for this project.
103103

104+
## Automated closure of issues Process
105+
106+
In an effort to keep the list of issues up to date and easier to navigate through, issues get closed automatically when they become inactive.
107+
108+
This process makes use of the following labels:
109+
110+
* Needs author feedback: the issue has been replied to by the triage team and is awaiting a follow up from the issue's author. This label needs to be added manually by people doing triage/experts whenever they reply. It's removed automatically by the workflow.
111+
* No recent activity: the issue hasn't received a reply from its author within the last 10 days since `Needs author feedback` was added and will be closed within 28 days if the author doesn't follow up. This label is added/removed automatically by the workflow.
112+
* Needs attention: The issue's author has replied since the `Needs author feedback` label was set and the triage team will reply as soon as possible. This label needs to be removed manually by people doing triage/experts whenever they reply. It's added automatically by the workflow.
113+
114+
## Automated TDC agenda issues Process
115+
116+
An issue is opened every week, 7 days in advance, for the Technical Direction Committee (TDC), it provides the information to connect the the meeting, and serves as a placeholder to build the agenda for the meeting. Anyone is welcome to attend the meeting, or to add items to the agenda as long as they plan on attending to present the item. These issues are also automatically pinned for visibility and labeled with "Housekeeping".
117+
118+
Ten (10) days after the meeting date is passed (date in the title of the issue), it gets closed and unpinned automatically.
119+
104120
## Participation
105121

106122
While governance of the specification is the role of the TSC, the evolution of the specification happens through the participation of members of the developer community at large. Any person willing to contribute to the effort is welcome, and contributions may include filing or participating in issues, creating pull requests, or helping others with such activities.

0 commit comments

Comments
 (0)