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: CONTRIBUTING.md
+22-10
Original file line number
Diff line number
Diff line change
@@ -4,57 +4,68 @@ Welcome to the FoundationDB community, and thank you for contributing! The follo
4
4
5
5
If you have questions, we encourage you to engage in discussion on the [community forums](https://forums.foundationdb.org). Pull requests to update and expand this guide are also welcome.
6
6
7
-
####Table of Contents
7
+
## Table of Contents
8
8
9
9
*[Before you get started](#before-you-get-started)
10
-
* [Community Guidelines](#community-guidelines)
11
-
* [Project Licensing](#project-licensing)
12
-
* [Governance and Decision Making](#governance-and-decision-making)
10
+
*[Community Guidelines](#community-guidelines)
11
+
*[Project Licensing](#project-licensing)
12
+
*[Governance and Decision Making](#governance-and-decision-making)
13
13
*[Contributing](#contributing)
14
-
* [Opening a Pull Request](#opening-a-pull-request)
15
-
* [Reporting Issues](#reporting-issues)
14
+
*[Opening a Pull Request](#opening-a-pull-request)
15
+
*[Reporting Issues](#reporting-issues)
16
16
*[Project Communication](#project-communication)
17
-
* [Community Forums](#community-forums)
18
-
* [Using GitHub Issues and Community Forums](#using-github-issues-and-community-forums)
19
-
* [Project and Development Updates](#project-and-development-updates)
17
+
*[Community Forums](#community-forums)
18
+
*[Using GitHub Issues and Community Forums](#using-github-issues-and-community-forums)
19
+
*[Project and Development Updates](#project-and-development-updates)
20
20
21
21
## Before you get started
22
+
22
23
### Community Guidelines
24
+
23
25
We want the FoundationDB community to be as welcoming and inclusive as possible, and have adopted a [Code of Conduct](CODE_OF_CONDUCT.md) that we ask all community members to read and observe.
24
26
25
27
### Project Licensing
28
+
26
29
By submitting a pull request, you represent that you have the right to license your contribution to Apple and the community, and agree by submitting the patch that your contributions are licensed under the Apache 2.0 license.
27
30
28
31
### Governance and Decision Making
32
+
29
33
At project launch, FoundationDB has a light governance structure. The intention is for the community to evolve quickly and adopt additional processes as participation grows. Stay tuned, and stay engaged! Your feedback is welcome.
30
34
31
35
We draw inspiration from the Apache Software Foundation's informal motto: ["community over code"](https://blogs.apache.org/foundation/entry/asf_15_community_over_code), and their emphasis on meritocratic rules. You'll also observe that some initial community structure is [inspired by the Swift community](https://swift.org/community/#community-structure).
32
36
33
-
The project technical lead is Evan Tschannen (ejt@apple.com).
37
+
The project technical lead is Jingyu Zhou (jingyu_zhou@apple.com).
34
38
35
39
Members of the Apple FoundationDB team are part of the initial core committers helping review individual contributions; you'll see them commenting on your pull requests. Future committers to the open source project, and the process for adding individuals in this role will be formalized in the future.
36
40
37
41
## Contributing
42
+
38
43
### Opening a Pull Request
44
+
39
45
We love pull requests! For minor changes, feel free to open up a PR directly. For larger feature development and any changes that may require community discussion, we ask that you discuss your ideas on the [community forums](https://forums.foundationdb.org) prior to opening a PR, and then reference that thread within your PR comment.
40
46
41
47
CI will be run automatically for core committers, and for community PRs it will be initiated by the request of a core committer. Tests can also be run locally via `make test`, and core committers can run additional validation on pull requests prior to merging them.
42
48
43
49
### Reporting issues
50
+
44
51
Please refer to the section below on [using GitHub issues and the community forums](#using-github-issues-and-community-forums) for more info.
45
52
46
53
#### Security issues
54
+
47
55
To report a security issue, please **DO NOT** start by filing a public issue or posting to the forums; instead send a private email to [[email protected]](mailto:[email protected]).
48
56
49
57
## Project Communication
58
+
50
59
### Community Forums
60
+
51
61
We encourage your participation asking questions and helping improve the FoundationDB project. Check out the [FoundationDB community forums](https://forums.foundationdb.org), which serve a similar function as mailing lists in many open source projects. The forums are organized into three sections:
52
62
53
63
*[Development](https://forums.foundationdb.org/c/development): For discussing the internals and development of the FoundationDB core, as well as layers.
54
64
*[Using FoundationDB](https://forums.foundationdb.org/c/using-foundationdb): For discussing user-facing topics. Getting started and have a question? This is the place for you.
55
65
*[Site Feedback](https://forums.foundationdb.org/c/site-feedback): A category for discussing the forums and the OSS project, its organization, how it works, and how we can improve it.
56
66
57
67
### Using GitHub Issues and Community Forums
68
+
58
69
GitHub issues and the community forums both offer features to facilitate discussion. To clarify how and when to use each tool, here's a quick summary of how we think about them:
59
70
60
71
GitHub Issues should be used for tracking tasks. If you know the specific code that needs to be changed, then it should go to GitHub Issues. Everything else should go to the Forums. For example:
@@ -65,4 +76,5 @@ GitHub Issues should be used for tracking tasks. If you know the specific code t
65
76
* Implementing an agreed upon feature: *GitHub Issues*
66
77
67
78
### Project and Development Updates
79
+
68
80
Stay connected to the project and the community! For project and community updates, follow the [FoundationDB project blog](https://www.foundationdb.org/blog/). Development announcements will be made via the community forums' [dev-announce](https://forums.foundationdb.org/c/development/dev-announce) section.
0 commit comments