Kanika637 / amazon-clone

Clone of Amazon Website
MIT License
89 stars 100 forks source link
clone css development firebase git good-first-issue hacktoberfest hacktoberfest-accepted hacktoberfest-starter hacktoberfest2022 html javascript open-source react

Contributing to amazon clone

Hurray!, you're here!✨. This is the first step in making your contribution to the amazon clone project. This documentation will serve as a guide for making your contibutions to this project. Follow the steps stated below carefully.

Finally, we can't wait to see your outstanding issues and pull requests. Welcome πŸ˜‡β€

πŸ“ Table of Contents

Ground Rules

Here at amazon clone, we welcome everyone to contribute to our project. You can contribute in several ways not just in code (E.g. Technical writing).

Having numerous means of contributing means working with alot of individuals which is very good for the growth πŸ“ˆ of the project but most times can lead to conflicting interests and point of views πŸ‘ˆπŸ‘‰. Below are set of rules πŸ“– that guide individuals participating in this project.

Things to take care while making a PR:

Your First Contribution

Is this your first time contributing to an open source project? If yes, Welcome!!βœ¨πŸŽ‰πŸ’ƒπŸΎ Here is a great tutorial on how to contribute to an open source project.

At this point you are ready to take on the world of open source contribution!!.

You must have seen a bug or problem you can fix, this is when you open a new issue for that problem. Let's do it together.

Steps to open a new issue

issues1

issues2

issues3

issues4

issues5

issues6

Hurray, you just made added your first issue. The managers of amazon clone will now review your issue and you will either get assigned to the issue, have it closed or a comment will be dropped for you.

You have been assigned an issue πŸ₯‚ and are confused 😡 about where to go from here, follow this guide below to make your changes and pull request 🍾.

Getting Started

Skip all of the steps below by using Gitpod, which would automatically do all of that for you

Open in Gitpod

or

Fork the amazon clone repository. See below πŸ‘‡

fork

Clone the repository you forked above. See below πŸ‘‡

clone

Using the command below, you can clone the repo.

git clone https://github.com/Kanika637/amazon-clone.git

Navigate to the cloned directory using command line. See below πŸ‘‡

cd amazon-clone

Install all the dependencies. See below πŸ‘‡

npm i

Make a new branch. See below πŸ‘‡

branch


git checkout -b "Your Branch Name"

A good branch name would begin with the issue ticket and the assigned issue. See below πŸ‘‡

// "#343" is the issue ticket number and "make a request" is the assigned issue name.

git checkout -b "#343-make a request"

You are all set!! πŸΎπŸŽ‰. You can now make your changes locally. Once you are done making all your changes, you can now push code and make a pull request.

Steps for making a pull request

You have to switch to the main branch and make sure it's up to date with the amazon's clone main branch. To do so, use the following commands below.

git remote add upstream https://github.com/Kanika637/amazon-clone.git
git checkout main
git pull upstream main

You can now update your branch from your local copy of main, and push it!. See how below. πŸ‘‡

git add .
git commit -m "<your commit message>"
git push origin <name-of-your-branch>

Hurray!!, we are done with the hard part. Head to github to make the pull request Github will check for conflicts and if non is found, you can make the pull request and the mainteners of amazon clone will review your pull request to have it merged or make a comment on it.

Code review process

The maintainer of amazon-clone looks at Pull Requests on a regular basis and carries out merging or comments on the requests. You can close a pull request if it isn't showing any activity after two weeks.

Commit messages

Amazon-clone has certain conventions that should be adopted when contributing.

Commit message conventions.

Thanks to all Contributors

Don't forgot to give a ⭐ to the repo, if you learned something!