We don't care if you break things. This is a playground and we encourage failing, because that means you at least try. Use this as a practice ground and enjoy contributing to projects you create and maintain with your fellow students.
If you're brand new to version control, no worries, we lead you step by step through this. Maybe have a read at GETTING_STARTED or GLOSSARY for some vocabulary. If you're really stuck on something, you could always ask in the Discord in #dev-ops or the specific projects channel.
You can learn about the workflow in-depth here.
On the GitHub page for this repository, click on the "Fork"-Button. Then clone your forked repository to your computer. For example by running this command inside your terminal:
git clone https://github.com/<your-github-username>/getting-started.git
Don't forget to replace <your-github-username>!
Before you make any changes, keep your fork in sync to avoid merge conflicts:
git remote add upstream https://github.com/protocode-community/getting-started.git
git pull upstream main
If you run into a merge conflict, you have to resolve the conflict. There are a lot of guides about this topic.
On your computer, open your text editor, and add your name to the CONTRIBUTORS.md file.
Add the changes with git add, git commit (write a nice commit message):
git add CONTRIBUTORS.md
git commit -m "Add <your-github-username>"
Replace <your-github-username>!
Push your changes to your repository:
git push origin main
Go to the GitHub page of your fork, and make a pull request.
Check out this free how-to at http://makeapullrequest.com/.
Pull requests are proposed changes to a repository submitted by a user and accepted or rejected by a repository's collaborators. Like issues, pull requests each have their own discussion forum.
Read more about pull requests on the GitHub help pages.
Wait until one of the maintainers merges your pull request.
Go join a project and start contributing or add your own!