Skip to content

Commit

Permalink
Create CONTRIBUTING.md
Browse files Browse the repository at this point in the history
  • Loading branch information
p1ng-request authored Dec 5, 2022
1 parent b2aebd0 commit b321da9
Showing 1 changed file with 84 additions and 0 deletions.
84 changes: 84 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
# 💥 How to Contribute

[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/Kanaries/Rath/pulls)
[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://join.slack.com/t/kanaries/shared_invite/zt-1k60sgaxu-aGcuS7CwGeJUccE61iGopg)

## 💪 What can I contribute?
You can contribute to RATH in any form that you would like to! For instance, you may:

- Participation in the community, by answering questions on GitHub open issues and in our chat groups, helps us maintain a healthy and active community of users.
- We welcome your proposals for new features, as well as reporting issues and bugs to RATH.
- Submit codes to RATH.
- Other contributions include suggestions for website improvements and documentation.
- Become a Top RATH Committer!

## 📐 The contribution workflow
Here's a step-by-step guide to contributing code to RATH:

- Take a look at the existing [Issues](https://github.com/Kanaries/Rath/issues) or [create a new issue](https://github.com/Kanaries/Rath/issues/new/choose)!
- [Fork the Repo](https://github.com/Kanaries/Rath/fork) from our GitHub. Create a branch for any issue that you are working with, and commit your work.
- Create a **[Pull Request](https://github.com/Kanaries/Rath/compare)** (a.k.a. Create a *PR*). We will review and process your Pull Request.
- Now that your Pull Request has been approved, you've officially become a **RATH** Committer!

>For the first-time committer to submit a pull request, [join us](join#-need-help) for assistance!
## 🐞 How can I report an issue?
The open-source community values constructive questions. Before submitting an issue, make sure you have done your research:

- Avaialble documentations and FAQ.
- Open issues on our GitHub repo.
- Existing Pull Requests.

[Open an issue](https://github.com/Kanaries/Rath/issues) on the GitHub page with a detailed description of the problem. The community will be happy to help!

## 👾 How to make a Pull Request

1. Navigate to our [GitHub page](https://github.com/Kanaries/Rath). Click on the **Fork** button at the top right corner.

2. Clone your forked repo to work with it locally:

```bash
git clone https://github.com/github-username/Rath.git
# Clone your repo
git remote -v
# Check if the upstream repo has been configured.
git remote add upstream https://github.com/Kanaries/Rath.git
# If not, add the upstream remote manually.
cd Rath
```

3. Create a branch

```bash
git fetch upstream
git checkout master
git rebase upstream/master
git push origin master
# Keep your local fork up to date.
git checkout -b branch-name
```

4. Commit and push changes to GitHub

```bash
git status
# Check what codes your've changed.
git add
# Check what files you've added to the git branch.
git commit -m "Your remarks"
# Commit
git push origin branch-name
# Push your branch to the repo's remote name.
```

5. Open a pull request on GitHub

Visit your repo's GitHub page. Click on the "Compare&pull request" button at the top of the page.

> Don't forget to provide the necessary information for your Pull Request! You will be notified via email once the PR request has been approved.
## 🥇 Submit a blog post
We are looking for guest bloggers to contribute posts to our blog. We encourage active users, top committers, and experts in the field to create interesting and informative content.
We are always on the lookout for high-quality submissions, so if you have a passion for writing and have something to say, we'd love to hear from you!

[![forthebadge](https://forthebadge.com/images/badges/built-with-love.svg)](https://forthebadge.com)

0 comments on commit b321da9

Please sign in to comment.