Contributing to Python: Difference between revisions

From OpenHatch wiki
Content added Content deleted
imported>Jesstess
No edit summary
imported>Jesstess
No edit summary
Line 7: Line 7:
IRC is a real-time chat protocol that open source projects often use to talk about the project and as a medium for users and developers to help each other.
IRC is a real-time chat protocol that open source projects often use to talk about the project and as a medium for users and developers to help each other.


* [[PyCon_intro_to_open_source/Windows IRC|Windows]]
* [[Contributing_to_Python/Windows IRC|Windows]]
* [[PyCon_intro_to_open_source/OSX IRC|OS X]]
* [[Contributing_to_Python/OSX IRC|OS X]]
* [[PyCon_intro_to_open_source/Linux IRC|Linux]]
* [[Contributing_to_Python/Linux IRC|Linux]]


== Goal #2: practice navigating from the command line ==
== Goal #2: practice navigating from the command line ==
Line 15: Line 15:
Many of the tools of open source development are primarily used via the command line. Let's get some practice with navigating the computer from the command line.
Many of the tools of open source development are primarily used via the command line. Let's get some practice with navigating the computer from the command line.


* [[PyCon_intro_to_open_source/Windows_command_line|Windows]]
* [[Contributing_to_Python/Windows_command_line|Windows]]
* [[PyCon_intro_to_open_source/OSX command line|OS X]]
* [[Contributing_to_Python/OSX command line|OS X]]
* [[PyCon_intro_to_open_source/Linux command line|Linux]]
* [[Contributing_to_Python/Linux command line|Linux]]


== Goal #3: install a text editor ==
== Goal #3: install a text editor ==
Line 25: Line 25:
If you already have a preferred text editor, skip this step.
If you already have a preferred text editor, skip this step.


* [[PyCon_intro_to_open_source/Windows text editor|Windows]]
* [[Contributing_to_Python/Windows text editor|Windows]]
* [[PyCon_intro_to_open_source/OSX text editor|OS X]]
* [[Contributing_to_Python/OSX text editor|OS X]]
* [[PyCon_intro_to_open_source/Linux text editor|Linux]]
* [[Contributing_to_Python/Linux text editor|Linux]]


== Goal #4: Get familiar with the Python bug tracker ==
== Goal #4: Get familiar with the Python bug tracker ==

Revision as of 03:13, 5 March 2014

Welcome! This page contains instructions for prospective OPW and Google Summer of Code interns, as well as anyone else interested in contributing to Python.

Part 1: environment setup

Goal #1: install an IRC client

IRC is a real-time chat protocol that open source projects often use to talk about the project and as a medium for users and developers to help each other.

Goal #2: practice navigating from the command line

Many of the tools of open source development are primarily used via the command line. Let's get some practice with navigating the computer from the command line.

Goal #3: install a text editor

We need a good text editor (not a word processor!) for editing Python code.

If you already have a preferred text editor, skip this step.

Goal #4: Get familiar with the Python bug tracker

Python tracks bugs and features at http://bugs.python.org/.

Please familiarize yourself with how Python uses its bug tracker by exploring and finding answers to the following questions:

1. What is the oldest open Python ticket?
1. How many open issues need a patch?
1. How many "critical"-level open issues are there?

Goal #5: Version control

Mercurial is the distributed version control system Python uses to manages changes to its code.

If you have not used Mercurial before, please go through this tutorial: http://hginit.com/

Goal #6: creating patches

If you have not used diff and patch before, please go through the diff and patch training mission at:

http://openhatch.org/missions/diffpatch

Part II: contributing to Python

Join the Python core-mentorship mailing list and introduce yourself: https://mail.python.org/mailman/listinfo/core-mentorship. Read the Python developer guide: http://docs.python.org/devguide/ Create an account on the Python bug tracker: http://bugs.python.org/ Submit a patch for a Python bug (see the next section for help getting started) Let the core mentorship mailing list know that you've submitted your patch and are ready to work on your application. We'll craft an application together for a project that fits your background and interests and what you want to learn this summer!