![Page 1: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/1.jpg)
Contributing to EPANETusing GitHub in Windows
Demetrios Eliades, Sam Hatchett, Elad Salomons
![Page 3: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/3.jpg)
Fork repository
![Page 4: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/4.jpg)
Select accountto fork repository
![Page 5: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/5.jpg)
Select your forked repository
Select the “dev” branch.This branch includes all the contributionsthat are going to be included inthe next EPANET version.You should use this branchas a basis for your contributions.
![Page 6: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/6.jpg)
Select the “dev” branch
![Page 7: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/7.jpg)
Create a new branch, based on “dev”,by giving it a name and by pressing the blue button
![Page 8: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/8.jpg)
You have created a new branch based on “dev”
![Page 10: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/10.jpg)
Select the green button to clonethe repository to your computer
![Page 11: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/11.jpg)
Press blue button to clone codein GitHub Desktop software
![Page 12: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/12.jpg)
GitHub will open and askto specify a local folder
![Page 13: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/13.jpg)
The repository is being cloned on your computer
![Page 14: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/14.jpg)
![Page 15: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/15.jpg)
Repository cloning finished
![Page 16: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/16.jpg)
Select the new repository
![Page 17: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/17.jpg)
Select the branch you want to work with.In this case “contributor-*”
![Page 18: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/18.jpg)
If you in are correct branch (see top):right click on EPANET and “open in Explorer”,or press “open this repository”.
What you view when you openthis folder depends on what you haveselected as branch (see top).
![Page 19: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/19.jpg)
Select and openthe file you want to edit
![Page 20: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/20.jpg)
Edit text (before)
![Page 21: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/21.jpg)
Edit text (after)
![Page 22: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/22.jpg)
On GitHub desktopthe changes are detectedautomatically andshown in green.
![Page 23: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/23.jpg)
Write a descriptive titleof the change you’ve made.You can add a more detaileddescription if needed.
Press Commit to savechanges to the branch locally.
![Page 24: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/24.jpg)
After Commit is completed, the branch path is expanded, locally, with a new “point”.
To apply the change toyour private GitHub repository,press Sync
![Page 25: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/25.jpg)
Syncing in progress
![Page 26: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/26.jpg)
Syncing completed
![Page 27: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/27.jpg)
The updated branch willappear in your repository
Press this to compareyour new branchand request to pullyour code to the original branch
![Page 28: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/28.jpg)
Select the destination branch (typically OpenWaterAnalytics/EPANET/dev)
![Page 29: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/29.jpg)
Select your branch with thenew code additions.If everything is OK, you should seethe indication “Able to merge” automatically
![Page 30: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/30.jpg)
You can add some further comments. You may mention specific people,using @ + their username.If this commit is related to an open issue, mention it using # + their number.
![Page 31: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/31.jpg)
On the same page, you can review the changes.
![Page 32: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/32.jpg)
Press “Create pull request” to make a review requestto include your contribution to theOpenWaterAnalytics/EPANET/dev branch.
![Page 33: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/33.jpg)
The pull request will appear in theOpenWaterAnalytics/EPANET repositoryunder “Pull requests”.
Now your contribution will be reviewedby the development team.
![Page 34: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/34.jpg)
In the meantime you can review the changes youhave submitted
![Page 35: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/35.jpg)
![Page 36: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/36.jpg)
If your contributionis accepted, then it ismerged to the dev branch
You can safely delete your temporarypersonal branch, if you want.
![Page 37: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/37.jpg)
Personal branch safely deleted
![Page 38: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/38.jpg)
You contribution is now availableand will be incorporated in a futureEPANET version
![Page 39: Contributing to EPANET using GitHub in Windows](https://reader035.vdocuments.site/reader035/viewer/2022062306/58a62abb1a28ab416c8b5ea1/html5/thumbnails/39.jpg)
Congratulations on your commit!