= Getting Started as an OPW applicant =

Hooray!  Thanks for your interest in working on the Linux kernel.

If you run into any issues with this tutorial, please ask questions on the [https://live.gnome.org/OutreachProgramForWomen#Introduction #opw IRC channel]

= Intro =

This tutorial will cover how to get your first patch submitted.  We would love it if accepted interns could test their kernel code on a computer running Linux, however, to get applicants started, this tutorial will describe how to set Linux up in a virtual machine.

You can run Linux from within Windows (or even run Linux on Linux!) from a virtual machine (VM).  This tutorial will show you how to:
 * Install VMPlayer
 * Download our Linux VM image
 * Configure kernel drivers
 * Compile and install the kernel
 * Make a simple driver change
 * Test your changes
 * Create a patch
 * Submit a patch

= Hardware Requirements =

If you're running Windows, you need a system with virtualization (VT-d), at least 4GB of RAM, and 40GB of free hard drive space.

== Alternatives ==

If your system doesn't meet those requirements, you will need to dual boot your machine with Linux.  We strongly suggest you use the [http://www.ubuntu.com/download/desktop/thank-you?distro=desktop&bits=64&release=lts Ubuntu 12.04 64-bit version].  If your machine doesn't have 64-bit support, you can use the [http://www.ubuntu.com/download/desktop/thank-you?release=lts&bits=32&distro=desktop&status=zeroc 32-bit version].

Once you've installed Linux, or if you already have Linux installed on your system, you can follow [:OPWfirstpatchAlt:these directions].

= Install VMPlayer =

Go to the [http://www.vmware.com/products/player/ VMPlayer website] and click the 'download' link.  Download the VMPlayer that's appropriate for your operating system (e.g. Windows or Linux 64-bit), and install it.

= Download our Linux VM image =

= Configure kernel drivers =

= Compile and install the kernel =

= Make a driver change =

= Test your changes =

= Create a patch =

= Submit a patch =

TODO:
 * Outline of what this tutorial covers
 * If you run into any issues, ask on the opw irc channel, or email sarah.a.sharp at linux.intel.com
 * Find out which drivers you have installed (maybe plug in any USB devices on hand)
 * Make small change in one of the drivers (e.g. run checkpatch over them, or fix some grammer in the printks)
 * Or maybe pick a driver in staging and run checkpatch on it
 * Test your patch (may need to enable debugging)
 * Make a patch (link to art of patch description creation)
 * Send patch to kernel newbies mailing list as RFC (perhaps we need a separate mailing list?)