PyCon intro to open source: Difference between revisions

Content added Content deleted

Inline

Latest revision as of 17:02, 10 April 2014

» Short URL for this material: http://bit.ly/open-source1 «

This page contains setup instructions for Contribute with me! Getting started with open source development.

Goal #1: install a text editor

(Estimated completion time: 2 - 10 minutes)

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

If you already have a preferred text editor, you can use it instead, but note that word processors like Microsoft Word and Notepad will not work.

Goal #2: install `git`

(Estimated completion time: 5 minutes)

git is a popular version control system, which we'll use for managing and collaborating on open source projects.

Goal #3: practice command line navigation

(Estimated completion time: 10 - 15 minutes)

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 #4: install an IRC client

(Estimated completion time: 5 minutes)

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 #5: create an OpenHatch account

(Estimated completion time: 2 minutes)

OpenHatch is a non-profit that helps connect people with open source projects. We'll use some of the tools on this site to practice.

» Please visit http://openhatch.org/ now and create an account. «

Goal #6: create a GitHub account

(Estimated completion time: 2 minutes)

GitHub is a popular website for hosting open source projects that use Git. We'll use GitHub to collaborate on projects..

» Please visit https://github.com/ now and create an account. «

Success!

You've set up your development environment and are a terminal pro. You are ready for the tutorial.

The tutorial is on Thursday, April 10th from 1:20pm - 4:40pm in Room 521 A.

@@ Line 1: / Line 1: @@
+<gallery widths="240px" heights="160px" perrow="4">
-== Goal #1: practice navigating from the command line ==
+File:Spang_helping.jpg
+File:Together.jpg
+File:Bpw2-breakout.jpg
+</gallery>
+<div style="font-size:125%">&raquo; Short URL for this material: http://bit.ly/open-source1 &laquo;</div>
-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]]
-* [[PyCon_intro_to_open_source/OSX command line|OS X]]
-* [[PyCon_intro_to_open_source/Linux command line|Linux]]
+<font size="+2">This page contains setup instructions for <i>Contribute with me! Getting started with open source development</i>.</font>
-== Goal #2: install a text editor ==
+== Goal #1: install a text editor ==
-In addition to being able to run Python, we are going to install a good text editor for writing and saving Python code during the workshop.<br />
+(Estimated completion time: 2 - 10 minutes)
-If you would like to use a different text editor from the recommendation for your operating system, please let a staff member know.
+We need a good text editor (not a word processor!) for editing Python code.
+If you already have a preferred text editor, you can use it instead, but note that word processors like Microsoft Word and Notepad will not work.
 * [[PyCon_intro_to_open_source/Windows text editor|Windows]]
@@ Line 17: / Line 22: @@
 * [[PyCon_intro_to_open_source/Linux text editor|Linux]]
-== Goal #3: install an IRC client ==
+== Goal #2: install <code>git</code> ==
+(Estimated completion time: 5 minutes)
+<code>git</code> is a popular version control system, which we'll use for managing and collaborating on open source projects.
+* [[PyCon_intro_to_open_source/Windows git|Windows]]
+* [[PyCon_intro_to_open_source/OSX git|OS X]]
+* [[PyCon_intro_to_open_source/Linux git|Linux]]
+== Goal #3: practice command line navigation ==
+(Estimated completion time: 10 - 15 minutes)
+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 terminal navigation|Windows]]
+* [[PyCon_intro_to_open_source/OSX terminal navigation|OS X]]
+* [[PyCon_intro_to_open_source/Linux terminal navigation|Linux]]
+== Goal #4: install an IRC client ==
+(Estimated completion time: 5 minutes)
 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.
@@ Line 25: / Line 55: @@
 * [[PyCon_intro_to_open_source/Linux IRC|Linux]]
-== Bonus material ==
+== Goal #5: create an OpenHatch account ==
-* Find and join an IRC channel for something you are interested in.
-** on Freenode, try channels like #python, #django
+(Estimated completion time: 2 minutes)
-** You can get a full list of Freenode's channels [http://irc.netsplit.de/channels/?net=freenode here]
+OpenHatch is a non-profit that helps connect people with open source projects. We'll use some of the tools on this site to practice.
+<div style="font-size:125%">[http://openhatch.org/ &raquo; Please visit http://openhatch.org/ now and create an account. &laquo;]</div>
+== Goal #6: create a GitHub account ==
+(Estimated completion time: 2 minutes)
+GitHub is a popular website for hosting open source projects that use Git. We'll use GitHub to collaborate on projects..
+<div style="font-size:125%">[https://github.com/ &raquo; Please visit https://github.com/ now and create an account. &laquo;]</div>
+==Success!==
+You've set up your development environment and are a terminal pro. You are ready for the tutorial.
+The tutorial is on Thursday, April 10th from 1:20pm - 4:40pm in Room 521 A.
+[[File:Champagne.png|100px]][[File:Party.png|125px]]