Welcome to Merge Me, an open source repository that allows you to practice making your first pull/merge requests.
As a new programmer, the thought of performing your first contribution can be a little scary. But it's time to put all your fears aside, pull yourself up, and git with the program. See what I did there?
If you open up index.html in the browser, you'll find a small application with a few features:
-
Directions for creating your first pull/merge request
-
An "I wuz here" section created for you to add in your code.
If you're comfortable with it, feel free to add in fun styling to the "I wuz here" title, container, or even create something new! All we ask is that you leave the directions alone, so others can have the same awesome learning experience you did.
If you attempt to contribute anything that breaks the code of conduct, your contribution will not be added.
After reading the directions, go ahead and try out making your first pull request. After you've competed everything correctly, pushed up your contribution to your branch, and it's approved, you'll be able see it on the main branch. That's all there is to successfully creating your first open source contribution on Github!
Users can access Merge Me by forking and cloning this repository.
- On the Top Right hand-side of the page, click the Fork button, If you do not fork the repository prior to cloning, all of the following directions will not work as desired.
-
After you've forked the repo, find the green "Code" button.Click it, and a tab should drop down including a github link (make sure to select the one under SSH).
-
Manually copy or click the clipboard icon to copy the link.
-
In the user terminal enter 'git clone':
user@Users-MacBook_Air % git clone [paste link]
- Navigate to the mergeMe file.
user@Users-MacBook_Air mergeMe %
- Once inside mergeMe, open the application in your browser by typing 'open index.html' in your terminal for Mac or 'explorer.exe index.html' for Windows:
user@Users-MacBook_Air mergeMe % open index.html
or
user@DESKTOP mergeMe$ explorer.exe index.html
- Inside 'index.html', you will be able to view the directions for How to Make your First Opensource Contribution on Github. Underneath the directions sheet, you will see the I wuz here section where you can freely add your code.
Congrats 🎉 you can now make your first contribution!
Since this application was primarily made for educational purposes, anyone is welcome to contribute. Make sure any pull requests have meaningfully commit messages that accurately and completely describe any changes. Do not include any changes that are not in the commit message.
Bug reports and pull requests are welcome on GitHub at https://github.com/mmeurer00/mergeMe. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
Everyone interacting in the Marge Me's project’s codebases, issue trackers, posts and users are expected to treat all others with respect and follow the code of conduct.