|
4 | 4 |
|
5 | 5 | ### Following the steps below will make your contribution process nice and easy |
6 | 6 |
|
7 | | -- Fork this project |
8 | | -- Clone it in your local machine |
9 | | -- Make a new branch, its best practice and important to make new branch for avoiding the merge conflicts. |
10 | | -- Make necessary changes on cloned project |
11 | | -- Commit, push, and create a pull request to master branch of this repo |
12 | | -- For more help on the process click [here](https://hacktoberfest.digitalocean.com/resources) |
| 7 | +## Step 1: Fork the repository |
| 8 | + |
| 9 | +Click the "Fork" button at the top of this page. This action will create a copy of this repository in your GitHub account. |
| 10 | + |
| 11 | +## Step 2: Clone the repository |
| 12 | + |
| 13 | +Go to your GitHub account, open the forked repository, click on the "Code" button, and then click the "Copy to clipboard" icon. |
| 14 | + |
| 15 | +Open your terminal and run the following command, replace `url copied` with the copied URL: |
| 16 | + |
| 17 | +```shell |
| 18 | +git clone "url copied" |
| 19 | +``` |
| 20 | + |
| 21 | +This will clone the forked repository to your local machine. |
| 22 | + |
| 23 | +## Step 3: Change the directory |
| 24 | + |
| 25 | +If not already there, run |
| 26 | + |
| 27 | +```shell |
| 28 | +cd ListExtender |
| 29 | +``` |
| 30 | + |
| 31 | +## Step 4: Create a branch |
| 32 | +Make a new branch, its best practice and important to make new branch for avoiding the merge conflicts. |
| 33 | +Use `git checkout` command to create your own branch. |
| 34 | + |
| 35 | +```shell |
| 36 | +git checkout -b NameOfYourBranch |
| 37 | +``` |
| 38 | + |
| 39 | +## Step 5: Make necessary changes |
| 40 | + |
| 41 | +Change the files or add as per the requirement/assignment. |
| 42 | + |
| 43 | +## Step 6: Check and Commit the changes |
| 44 | + |
| 45 | +If you run the `git status` command in your project directory, you'll see there are changes. Add those changes to the branch you created using the `git add` command: |
| 46 | + |
| 47 | +Example: If you changed exampleFile |
| 48 | + |
| 49 | +```shell |
| 50 | +git add exampleFile |
| 51 | +``` |
| 52 | + |
| 53 | +Now commit the changes: |
| 54 | + |
| 55 | +```shell |
| 56 | +git commit -m "Updated exampleFile" |
| 57 | +``` |
| 58 | + |
| 59 | +Replace Updated exampleFile with your short comment. |
| 60 | + |
| 61 | +## Step 7: Push your changes to GitHub |
| 62 | + |
| 63 | +Use the `git push` command to push your changes to GitHub: |
| 64 | + |
| 65 | +```shell |
| 66 | +git push origin -u NameOfYourBranch |
| 67 | +``` |
| 68 | + |
| 69 | +## Step 8: Submit your changes for review |
| 70 | + |
| 71 | +Go to your repository on GitHub, and you'll see a "Compare & pull request" button. Click on that button. |
| 72 | + |
| 73 | +Submit the pull request. By clicking on "Create pull request" |
| 74 | + |
| 75 | +## Step 9: Merged? |
| 76 | + |
| 77 | +You will receive a notification email once your changes have been merged. |
| 78 | + |
| 79 | +- For more help on the process visit [Hacktoberfest](https://hacktoberfest.digitalocean.com/resources) ! |
| 80 | + |
| 81 | +# Project Outline |
| 82 | + |
| 83 | +## For core library and logic |
| 84 | +- Checkout [lib](https://github.com/JLambertazzo/ListExtender/tree/master/lib) folder. |
| 85 | +- Also , for more instructions on using the library, visit: |
| 86 | +https://julienbl.me/ListExtender/documentation.html OR run [documentation](/documentation.html) on localhost. |
| 87 | + |
| 88 | +## Checkout the website |
| 89 | +- Click [index.html](/index.html) and run on localhost. |
| 90 | + |
| 91 | +## For Styling |
| 92 | +- Check [CSS](https://github.com/JLambertazzo/ListExtender/tree/master/css) folder. |
| 93 | + |
| 94 | +## For Script |
| 95 | +- Check [js](https://github.com/JLambertazzo/ListExtender/tree/master/js) folder. |
| 96 | + |
| 97 | +## For Examples and to Understand |
| 98 | +- Check [example](https://github.com/JLambertazzo/ListExtender/tree/master/examples.html) |
| 99 | + |
| 100 | +Also Check: [Readme.md](https://github.com/JLambertazzo/ListExtender/tree/master/README.md) |
0 commit comments