From f54a4fd949d8833878669402c5fb87af9c3fbef0 Mon Sep 17 00:00:00 2001 From: Dunsin <78784850+Dun-sin@users.noreply.github.com> Date: Sat, 1 Oct 2022 00:28:00 +0100 Subject: [PATCH] docs: add contributing file --- contributing.md | 81 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 81 insertions(+) create mode 100644 contributing.md diff --git a/contributing.md b/contributing.md new file mode 100644 index 00000000..1c1506e6 --- /dev/null +++ b/contributing.md @@ -0,0 +1,81 @@ +## 💥 How to Contribute + +- Take a look at the existing [Issues](https://github.com/openprivacytech/openprivacytech.org/issues) or [create a new issue](https://github.com/openprivacytech/openprivacytech.org/issues/new/choose)! +- [Fork the Repo](https://github.com/openprivacytech/openprivacytech.org/fork). Then, create a branch for any issue that you are working on. Finally, commit your work. +- Create a [Pull Request](https://github.com/openprivacytech/openprivacytech.org/compare) (PR), which will be promptly reviewed and given suggestions for improvements by the community. +- Add screenshots or screen captures to your Pull Request to help us understand the effects of the changes proposed in your PR. + +--- + +## 🌟 HOW TO MAKE A PULL REQUEST: + +1. Start by making a Fork of the [openprivacytech](https://github.com/openprivacytech/openprivacytech.org) repository. Click on the Fork symbol at the top right corner. + +2. Clone your new fork of the repository in the terminal/CLI on your computer with the following command: + +```bash +git clone https://github.com//openprivacytech +``` + +3. Navigate to the newly created openprivacytech project directory: + +```bash +cd openprivacytech +``` + +4. Set upstream command: + +```bash +git remote add upstream https://github.com/openprivacytech/openprivacytech.org.git +``` + +5. Create a new branch: + +```bash +git checkout -b YourBranchName +``` + +6. Sync your fork or your local repository with the origin repository: + +- In your forked repository, click on "Fetch upstream" +- Click "Fetch and merge" + +### Alternatively, Git CLI way to Sync forked repository with origin repository: + +```bash +git fetch upstream +``` + +```bash +git merge upstream/main +``` + +### [Github Docs](https://docs.github.com/en/github/collaborating-with-pull-requests/addressing-merge-conflicts/resolving-a-merge-conflict-on-github) for Syncing + +7. Make your changes to the source code. + +8. Stage your changes and commit: + +⚠️ Make sure not to commit package.json or package-lock.json file + +```bash +git commit -m"" +``` + +9. Push your local commits to the remote repository: + +```bash +git push origin YourBranchName +``` + +10. Create a [Pull Request](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request)! + +11. Congratulations! You've made your first contribution to [openprivacytech](https://github.com/openprivacytech/openprivacytech.org/graphs/contributors)! + +🏆 After this, the maintainers will review the PR and will merge it if it helps move the openprivacytech project forward. Otherwise, it will be given constructive feedback and suggestions for the changes needed to add the PR to the codebase. + +--- + +## 💥 Issues + +In order to discuss changes, you are welcome to [open an issue](https://github.com/openprivacytech/openprivacytech.org/issues/new/choose) about what you would like to contribute. Enhancements are always encouraged and appreciated.