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
+20-14Lines changed: 20 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,24 +6,39 @@ This guide outlines the process of landing patches in gocql and the general appr
6
6
7
7
## Background
8
8
9
-
The goal of the gocql project is to provide a stable and robust CQL driver for Go. gocql is a community driven project that is coordinated by a small team of core developers.
9
+
The goal of the gocql project is to provide a stable and robust CQL driver for Go. This is a community driven project that is coordinated by a small team of developers in and around the Apache Cassandra project. For security, governance and administration issues please refer to the Cassandra Project Management Committee.
10
10
11
11
## Minimum Requirement Checklist
12
12
13
13
The following is a check list of requirements that need to be satisfied in order for us to merge your patch:
14
14
15
-
* You should raise a pull request to gocql/gocql on Github
15
+
* You should raise a pull request to apache/cassandra-gocql-driver on Github
16
16
* The pull request has a title that clearly summarizes the purpose of the patch
17
17
* The motivation behind the patch is clearly defined in the pull request summary
18
-
*Your name and email have been added to the `AUTHORS` file (for copyright purposes)
18
+
*You agree that your contribution is donated to the Apache Software Foundation (appropriate copyright is on all new files)
19
19
* The patch will merge cleanly
20
-
* The test coverage does not fall below the critical threshold (currently 64%)
21
-
* The merge commit passes the regression test suite on Travis
20
+
* The test coverage does not fall
21
+
* The merge commit passes the regression test suite on GitHub Actions
22
22
*`go fmt` has been applied to the submitted code
23
23
* Notable changes (i.e. new features or changed behavior, bugfixes) are appropriately documented in CHANGELOG.md, functional changes also in godoc
24
+
* A correctly formatted commit message, see below
24
25
25
26
If there are any requirements that can't be reasonably satisfied, please state this either on the pull request or as part of discussion on the mailing list. Where appropriate, the core team may apply discretion and make an exception to these requirements.
26
27
28
+
## Commit Message
29
+
30
+
The Apache Cassandra project has a commit message precendence like
31
+
```
32
+
<One sentence description, usually Jira title or CHANGES.txt summary>
33
+
34
+
patch by <Authors>; reviewed by <Reviewers> for CASSANDRA-#####
35
+
```
36
+
37
+
The 'patch by …; reviewed by' line is important. It permits our review-than-commit procedure, allowing commits from non-git-branch patches. It is also parsed to build the project contribulyse statistics found [here](https://nightlies.apache.org/cassandra/devbranch/misc/contribulyze/html/).
In addition to stating the hard requirements, there are a bunch of things that we consider when assessing changes to the library. These soft requirements are helpful pointers of how to get a patch landed quicker and with less fuss.
@@ -45,12 +60,3 @@ Generally speaking, a pull request can get merged by any one of the project's co
45
60
### Supported Features
46
61
47
62
gocql is a low level wire driver for Cassandra CQL. By and large, we would like to keep the functional scope of the library as narrow as possible. We think that gocql should be tight and focused, and we will be naturally skeptical of things that could just as easily be implemented in a higher layer. Inevitably you will come across something that could be implemented in a higher layer, save for a minor change to the core API. In this instance, please strike up a conversation in the Cassandra community. Chances are we will understand what you are trying to achieve and will try to accommodate this in a maintainable way.
48
-
49
-
## Officially Supported Server Versions
50
-
51
-
Currently, the officially supported versions of the Cassandra server include:
52
-
53
-
* 1.2.18
54
-
* 2.0.9
55
-
56
-
Chances are that gocql will work with many other versions. If you would like us to support a particular version of Cassandra, please start a conversation about what version you'd like us to consider. We are more likely to accept a new version if you help out by extending the regression suite to cover the new version to be supported.
0 commit comments