Project: open source

Opensource-Academy project: practise contributing to an open source project

Description

In this project you will practise with git repositories. Afterwards, you can make a small contribution to an open source project.

Practise

Git project 1

Get comfy by going through and finishing this practise project.

Git project 2

Continue by going through and finishing this practise project.

Aftermath

Now that you have worked with Git and GitHub, you are ready to make your first contribution to an open source project.

If you want to contribute to something, read on to learn where and how you could help.

Pick a project

Now try to think of something where you would like to help. If you need some help coming up with a project, or just want an introduction to some open source projects, read on.

Well known projects

This is a completely random list of open source projects.

Operating systems

Linux: https://github.com/torvalds/linux

Art & graphics

Pixel art: https://github.com/collections/pixel-art-tools

Text editors

Vim: https://github.com/vim/vim Spacemacs: https://github.com/syl20bnr/spacemacs Gedit: https://github.com/GNOME/gedit Lime: https://github.com/limetext/lime Atom: https://github.com/atom/atom Visual studio code: https://github.com/Microsoft/vscodei

Popular projects

See what's trending on GitHub: https://github.com/trending Bootstrap: https://github.com/twbs/bootstrap Jquery: https://github.com/jquery/jquery HTML5-Boilerplate: https://github.com/h5bp/html5-boilerplate Ruby on Rails: https://github.com/rails/rails D3: https://github.com/d3/d3

Browsers

Chromium: https://github.com/chromium/chromium Google Chrome: https://github.com/GoogleChrome/ Mozilla: https://developer.mozilla.org/en-US/docs/Mozilla/Developer_guide/Introduction

Search

Elastic Search: https://github.com/elastic/elasticsearch/ Apache Luncene and Solr: https://github.com/apache/lucene-solr

The big guys

Google: https://github.com/google Mozilla: https://github.com/mozilla Microsoft: https://github.com/microsoft Apple: https://github.com/applei Amazon Web Services: https://github.com/aws

Programming languages:

https://github.com/collections/programming-languages Go: https://github.com/golang/go Python: https://github.com/python/cpython Ruby: https://github.com/ruby/ruby Swift: https://github.com/apple/swift TypeScript: https://github.com/Microsoft/TypeScript PHP: https://github.com/PHP

Join a project

Once you have found something you would like to work on, you can simply make a fork and get going (assuming you found something on GitHub or a similar platform).

Reading the CONTRIBUTING file, general README and possible the wiki or project's (GitHub) homepage is probably a good place to start.

Make sure to read any guidelines on contributing, the project might require you to work with git in a certain way. If this is the case, you will usualy find any information regarding this matter in CONTRIBUTING.

If there is not CONTRIBUTING file, consider checking past pull requests.

Give back

Once you made you change, prepare your pull request as requested by the author(s) (usualy described in the project's CONTRIBUTING or README).

Wait and hope for the best

Now you simply wait and see what happens.

Option 1: Your contribution might not be accepted right away

As the title says, several reasons can lead to your contribution not being accepted (rigtt away). Usualy, the denial comes with an explanation on how your contribution can be made acceptable.

Option 2: You contribution gets accepted

If you managed to get your contribution into a project: well done and thank you for donating some of your time and effort to the community.

Option 3: You never hear back

:(

   Copyright 2018 Opensource Academy

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.