I think CONTRIBUTING.md <https://github.com/apache/cassandra/blob/b2037e473fb6438947d6ed9c58fbea5955cb72c4/CONTRIBUTING.md> needs a tweak, but I want to make sure I have the story straight before posting an edit.

Currently, it states "Apache Cassandra doesn't use GitHub pull requests as part of the development process. In fact, this repository is a GitHub mirror of the official repo <https://gitbox.apache.org/repos/asf/cassandra.git>." Except the "official repo" link points right back to the GitHub repo. :-)

Also, I'm not sure that the directions near the bottom of this page -- https://cassandra.apache.org/_/development/patches.html -- to "Attach the newly generated patch to the ticket/add a link to your branch and click "Submit Patch" at the top of the ticket. This will move the ticket into "Patch Available" status, indicating that your submission is ready for review" are still applicable: at least I haven't stumbled across the "Submit Patch" button/link yet.

My high-level understanding is:

1) Create a JIRA

2) Clone the repo

3) Create your feature branch, named with the JIRA id (CASSANDRA-12345)

4) Make, test, push, etc., your changes on your feature branch

5) When ready, create a PR in GitHub, and update the JIRA to indicate the PR has been posted (comment + link)

If that's correct, I'm happy to go edit the documentation appropriately (and with more polish than this email).

On the other hand, if I've tragically misunderstood then please correct me here (and I'm still happy to update documentation as needed).

Thanks -- Joel.

Reply via email to