Skip to content

Latest commit

 

History

History
128 lines (86 loc) · 5.44 KB

CONTRIBUTING.md

File metadata and controls

128 lines (86 loc) · 5.44 KB

🤝First time contributing? We will help you out. 👍

GitHub custom open for collaboration

Refer to the following articles on the basics of Git and Github and can also contact the Project Mentors, in case you are stuck:

If you don't have git on your machine, install it.

💥 How to Contribute

PRs Welcome Open Source Love

  • Take a look at the Existing Issues or create your own Issues!
  • Wait for the Issue to be assigned to you after which you can start working on it.
  • Fork the Repo and create a Branch for any Issue that you are working upon.
  • Read the Code of Conduct
  • Create a Pull Request which will be promptly reviewed and suggestions would be added to improve it.
  • Add Screenshots to help us know what this Script is all about.

⭐HOW TO MAKE A PULL REQUEST:

1. Fork this repository. Click on the symbol at the top right corner.

2. Clone the forked repository. Open terminal and type:

git clone https://github.com/<your-github-username>/Operationalizing-ML.git

3. Navigate to the project directory.

cd Operationalizing-ML     

4. Make a feature branch

git checkout -b <branch-name>

5. Make changes in source code/ project.

6. Stage your changes and commit

#Add changes to Index
git add .

#Commit to the local repo
git commit -m "<your_commit_message>"

7. Push your local commits to the remote repo.

git push origin <brach-name>

8. Create a PR !

9. Congratulations! Sit and relax, you've made your contribution to Operationalizing-ML project.

🏆 After this, project leaders and mentors will review the changes and will merge your PR if they are found good, otherwise we will suggest the required changes.

ADD A REMOTE (UPSTREAM) TO ORIGINAL PROJECT REPOSITORY


Remote means the remote location of project on Github. By cloning, we have a remote called origin which points to your forked repository. Now we will add a remote to the original repository from where we had forked.

$ cd <your-forked-project-folder> $ git remote add upstream https://github.com/<author-account-username>/<project>.git You will see the benefits of adding remote later.

SYNCHRONIZING YOUR FORK -


Open Source projects have a number of contributors who can push code anytime. So it is necessary to make your forked copy equal with the original repository. The remote added above called Upstream helps in this.

$ git checkout master $ git fetch upstream $ git merge upstream/master $ git push origin master The last command pushes the latest code to your forked repository on Github. The origin is the remote pointing to your forked repository on github.

SQUASHING YOUR COMMITS-


You have completed the feature, but you have made a number of commits which make less sense. You should squash your commits to make good commits.

$ git rebase -i HEAD~5 This will open an editor which will allow you to squash the commits.

Style Guides for Git Commit Messages:memo:

Here's a list of some good to have points, that can add more value to your contribution logs.

  • Use the present tense (example: "Add feature" and not "Added feature")
  • Use the imperative mood (example: "Move item to...", instead of "Moves item to...")
  • Limit the first line (also called subject line) to 50 characters or less
  • Capitalize the subject line
  • Separate subject from body with a blank line
  • Do not end the subject line with a period
  • Wrap the body at 72 characters
  • Use the body to explain what, why, vs, and how
  • Reference issues and pull requests liberally after the first line

For more detailed reference to the above points, refer here: https://chris.beams.io/posts/git-commit.

💥 Issues:

For major changes, you are welcomed to open an issue about what you would like to contribute. Enhancements will be appreciated.

All the Best!🥇

built by developers built with love