Skip to content

Latest commit

 

History

History
99 lines (71 loc) · 3.91 KB

CONTRIBUTING.md

File metadata and controls

99 lines (71 loc) · 3.91 KB
Raw

Contributing

We love contributions from everyone. By participating in this project, you agree to abide by the code of conduct

We expect everyone to follow the code of conduct anywhere in this project codebases, issue trackers, chatrooms, and mailing lists.

Contributing Code

Below are the steps to be followed to contribute to the repository. Lets together make this a wonderful repository 💪

1. Find an issue or Create your own issue

image

  • Take a look at the Existing issues or create your own issues! Link
  • Comment on the issue.
  • Wait for the admin to assign the issue to you after which you can start working on it.

Note : Your PR will only be approved if you are assigned to that issue. Also, every small project must have a associated issue for it.

2. Fork and Setup the Project

image

  • Fork this Repository. This will create a Local Copy of this Repository on your Github Profile.
  • Clone the repository into your system using the below command
$ git clone https:/<your-username>/code-n-stitch

Now, let's add a reference to the original Repository repository using

$ git remote add upstream https:/bislara/code-n-stitch.git

This adds a new remote named upstream.

  • If you have already forked the project, update pull from the upstream before working.
$ git remote update
$ git checkout <branch-name>
$ git rebase upstream/<branch-name>

3. Branch

Create a new branch. Follow the branch creation rule.

BRANCH CREATION RULE

  • Go to this link and see the issues created by you or assigned to you.
  • Create a new branch for each issue in your forked repository.
  • The name of your branch should follow the following rule: [ISSUE NO #]-[SUITABLE NAME ACCORDING TO THE TITLE OF THE ISSUE(all lowercase letters and words separated by a hyphen(-))].
  • That is, if the TITLE of the issue #8 is Dashboard - Development for Hospital, then the branch name should be 8-hospital-dashboard
$ git checkout -b branch_name

4. Work on the issue assigned

  • Work on the issue(s) assigned to you.
  • Create a new folder with suitable name.
  • Add all the files/folders needed.
  • After you've made changes or made your contribution to the project add changes to the branch you've just created by:
# To add all new files to branch Branch_Name
$ git add .

5. Commit

  • To commit give a descriptive message for the convenience of reveiwer by:
# This message get associated with all files you have changed
$ git commit -m 'message

6. Push your work to Github

  • Finally, push your work in your branch in Github.
$ git push -u origin Branch_Name

7. Pull Request (PR)

image

  • Go to your repository in browser and click on compare and pull requests. Then add a title and description to your pull request that explains your contribution. You can use the PR template to explain your work.
  • Treat master branch as your master branch, i.e. all your PRs should use master as the target branch.
  • Congrats! Your PR has been submitted and will be promptly reviewed and suggestions would be added by the admin to improve it.
  • Add Screenshots to help us know what this issue is all about.
  • Finally, It will be merged by the admin.

all the contributions from anyone to improve/add new code to this project are welcomed. Every small contributions matters and we are thankfull to all the contributors. 😇