You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/adr/adr-template.md
+15-3
Original file line number
Diff line number
Diff line change
@@ -2,36 +2,45 @@
2
2
3
3
This is the base template that we use
4
4
5
-
```
5
+
```md
6
+
6
7
# ADR [Number]: [Title of Decision]
7
8
8
9
## Status
10
+
9
11
[Proposed | Accepted | Deprecated | Superseded by ADR [number]]
10
12
11
13
## Submitters
14
+
12
15
[List of people who proposed this decision. Include GitHub usernames or names with contact information if needed.]
16
+
13
17
- @username1
14
18
- @username2
15
19
16
20
## Decision Owners
21
+
17
22
[List of people responsible for driving the decision and following up on its implementation. This may include teams or subject matter experts.]
23
+
18
24
- @owner1
19
25
- @team1
20
26
21
27
## Context
28
+
22
29
Describe the problem, need, or feature request that prompted this decision. Include any relevant background information, constraints, and considerations that were taken into account.
23
30
24
31
- **Why do we need this decision?**
25
32
- **What problem does it solve or avoid?**
26
33
- **Are there any existing issues/discussions/pull requests related to this?** (Include links to relevant GitHub issues, forum threads, or discussion channels.)
27
34
28
35
## Decision
36
+
29
37
Clearly state the decision that was made. Describe the chosen solution or approach in detail so that others can understand what was decided.
30
38
31
39
- **What will be done?**
32
40
- **What will not be done?** (If applicable, specify what was explicitly ruled out.)
33
41
34
42
## Rationale
43
+
35
44
Explain why this decision was made, including a discussion of the alternatives considered and why they were not chosen.
36
45
37
46
- **Alternatives Considered:**
@@ -41,13 +50,15 @@ Explain why this decision was made, including a discussion of the alternatives c
41
50
- **Why is this decision the best option?** (Explain the key factors that influenced this choice.)
42
51
43
52
## Consequences
53
+
44
54
Describe the positive and negative outcomes of the decision, including any potential risks or technical debt.
45
55
46
56
- **Positive Impact**: What benefits does this decision bring to the project?
47
57
- **Negative Impact**: What challenges or limitations does this introduce?
48
58
- **Mitigations**: How will we address potential drawbacks or issues?
49
59
50
60
## Implementation
61
+
51
62
(Optional, if relevant)
52
63
Outline the steps required to implement the decision. This section is particularly useful if the decision involves a series of actions or a roadmap.
53
64
@@ -56,19 +67,20 @@ Outline the steps required to implement the decision. This section is particular
56
67
- **Estimated Effort**: Provide a rough estimate of time or effort needed.
57
68
58
69
## References
70
+
59
71
Include any external links, documents, discussions, or research that were referenced during the decision-making process.
60
72
61
73
- [Link to relevant GitHub issue or pull request](#)
62
74
- [Link to forum discussion](#)
63
75
- [Documentation or research sources](#)
64
76
65
-
66
77
## Changelog
78
+
67
79
Track changes or updates to this ADR over time. Include the date, author, and a brief description of each change.
68
80
69
81
- **[YYYY-MM-DD]**: [@username] - [Brief description of the change]
70
82
- Example: **[2024-10-22]**: @owner1 - Updated the decision to include support for Redis caching.
71
83
- **[YYYY-MM-DD]**: [@username] - [Brief description of the change]
72
84
- Example: **[2025-01-15]**: @username2 - Deprecated this ADR due to a shift in the database strategy.
description: Guidelines for spending project funding
4
+
labels: ADR
5
+
---
6
+
7
+
# ADR [Number]: Funding Use Guidelines
8
+
9
+
## Status
10
+
11
+
Proposed
12
+
13
+
## Submitters
14
+
15
+
-@ctcpip
16
+
-@UlisesGascon
17
+
-@wesleytodd
18
+
19
+
## Decision Owners
20
+
21
+
-@expressjs/express-tc
22
+
23
+
## Context
24
+
25
+
We have an Open Collective but we originally decided to wait on setting guidelines for how we will spend the funds. Now that we have landed PRs to include the `funding` field in `package.json` and also a link in the footer of the website, we wanted to have some loose guidelines so contributors know a little about how we intend to use financial support for the project.
26
+
27
+
## Decision
28
+
29
+
Funds are not automatically distributed.
30
+
31
+
TC members may request funds to be distributed for the following purposes:
32
+
33
+
- Living expenses (food, shelter, medicine/healthcare, transportation, utilities)
34
+
- The requester need not specify any detail other than the amount being requested.
35
+
- Travel (hotel and airfare) to events related to Express or the greater Node/JS ecosystem. _Legal Requirement: at least 18 years old and recognized as adults in both the country of departure and the destination country, based on local laws (ref: [Age of Majority](https://en.wikipedia.org/wiki/Age_of_majority))_
36
+
- The requester should specify the event, location, and cost estimates for hotel and airfare.
37
+
- Equipment and hardware (devices, screens, internet services)
38
+
- The requester should specify the type of equipment or service needed and how it relates to their work on Express.
39
+
40
+
Requests will be reviewed at the next possible opportunity, privately during an Express TC meeting. The Express TC also reserves the right to amend these guidelines via our standard decision making process.
41
+
42
+
## Implementation
43
+
44
+
Once approved, we will add this doc to the appropriate places within our project documentation (the contributing guide, website, OC landing page, etc).
0 commit comments