Contributing code using GitHub

GitHub is a website created to make open source software development easier. Most of the open source projects on the Internet are hosted on GitHub. This includes the code for the Salt open source project.

GitHub allows anyone to clone the repository for a project and make changes, and then propose that these changes be included in the main repository for the project.

Creating an account on GitHub

The first step is to create an account. Navigate to https://github.com, where you'll see the signup page:

Pick a username, e-mail, and password, and click on Sign Up for GitHub.

The project

Once you sign into your new account, you can check out the Salt project! It's located at https://github.com/saltstack/salt:

Here, you can browse the code for the project, view the outstanding feature requests and bugs in the Issues view, browse the project wiki, view Salt releases, and much more.

Since we're looking to contribute, a good starting place is the Issues view...