Many people are daunted by the idea of making a their first contribution on public repositories. Hence, OpenSUTD has created this repository to encourage members of the SUTD community to learn more about open source and GitHub! This shall be a fun and harmless environment for you to make your first contribution on GitHub via pull requests (PRs).
This month is also Hacktoberfest, which means that you can get a free shirt mailed to you by contributing pull requests! Hacktoberfest is an annual, month-long celebration of open source software run by DigitalOcean and other sponsors. During this month (1 Oct to 31 Oct), contribute at least four pull requests to any GitHub respository and a free Hacktoberfest T-shirt will be mailed to you!
In the spirit of Hacktoberfest, quality PRs are encouraged. Hence this repository will not count towards four pull requests. However, we still encourage you to try to submit your first PR here in order to be more familiar with the process!
- Create a GitHub Account (link)
- Fork this repository (help)
- Make changes using the online editor (help)
- Submit a pull request! (help)
Note: You need to submit at least total of four pull requests (to any repository, except this one) to qualify for the free Hacktoberfest shirt.
For more information on how to get started with GitHub, also check out the Hello World Guide.
We encourage you to contribute various types and interpretations of D
s into this repository!
Examples (just some ideas) of possible contributions:
- Various
D
files (d.py
,d.txt
and so on - demonstrate your knowledge of file formats!) - Funny scripts that do things related to
D
- Dank stuff, I know we have many meme lords in the crowd
- For more ideas, check the repo or other contributions!
Just keep things harmless and safe for work! No indecent contributions will be tolerated
For more information, take a look at the Hacktoberfest FAQ.
This repo? It was loosely inspired by this legendary GitHub repository (story here), but instead of manymany e
s, we are doing manymanyD
s! Why? Because we're SUTD, and big D
is our thing, and we want to collect all kinds of D
s!
This is also inspired by other repositories set up during previous Hacktoberfests to encourage people from all around the globe to make their first public contributions on GitHub and the online open source community.
OpenSUTD was created to fufill a desire to create a community to:
- provide a way for people to spawn and sustain decentralised initiatives
- promote an organic movement in school to embrace open sharing and collaboration
- maintain a space for free and open knowledge sharing within and outside of the SUTD Community
OpenSUTD is not a fifth row where there is the notion of a member vs non-member. The only thing we recognise is contributions, and anyone can contribute. Contribution is not limited to code! We're always looking out for writers, designers, evangelists, community managers and more.
If you would like to get started but don't know how, do contact timothy_liu[at]mymail.sutd.edu.sg
.
This section contains detailed information on how to perform each step in order to submit your pull request successfully.
-
Starting from this page, click the "Fork" button around the top right hand corner.
-
GitHub will now fork (clone) this repository to your own GitHub profile.
-
Done! Now you have your own fork (copy) of our
OpenSUTD/DDDDDDDDDD
repository!
-
Now that you have your own fork, you can start to make changes. You can create and edit files right from within the browser. Just have fun and be creative with what you can create!
-
While editing the file, try to make it dank in some way!
-
After you're done, commit the file with a descriptive message.
Now you have already made changes to your own repository, and are ready to make a new pull request!
Now here is the process for submitting a new pull request:
-
You should see that your file is inside your fork. Click "New Pull Request".
-
You will see a summary of your changes. Go ahead and click on the big green button.
-
Leave a dank and descriptive message in the pull request.
When we see new pull requests, we'll merge them in!
What happens when your current repository is outdated from the original? It's time to rebase!
-
You will know that your repository is outdated if it says that it is "n commits behind master". Click on "Compare".
-
Change the base repository to your own repository.
-
Ohno, the page completely changes. Don't worry, just click on "Compare across forks".
-
Whew, we're back to the comparing changes page. Time to change the head repository to the original master, in this case "OpenSUTD/DDDDDDDDDDD". You should be able to see the changes below.
-
Go ahead and create a PR from that
-
I think you know what to do from here.
-
Because this is your own repository, you're gonna have to merge it in yourself!
Aaaaand that's it! You now have a fully updated repository.