The Public Lab Developers group is an open group for Public Lab related (or -interested) programmers and developers. Float ideas, solicit feedback, get involved in existing PL programming projects, or start your own!

###Sign up

<form class="form" action="https://groups.google.com/group/plots-dev/boxsubscribe">
<div class="form-inline">
<input class="form-control input-medium" type="text" name="email" placeholder="you@email.com" />
<input class="btn btn-default" type=submit name="sub" value="Subscribe" />
</div>
</form>

##How to contribute

**We are actively seeking contributors**, so please introduce yourself on the developers list and ask about how you can help keep these free and open source software projects working (and improving) for our thousands of community members!

Start by [reading our contribution guidelines](/wiki/contributing-to-public-lab-software)

## Public Lab Software

<table>
<tr>
    <th>Project</th>
    <th>Description</th>
    <th>Source Code</th>
</tr>
<tr>
    <td><a href="/">PublicLab.org</a></td>
    <td>This very website!</td>
    <td><a href="https://github.com/publiclab/plots2">github:publiclab/plots2</a></td>
</tr>
<tr>
    <td><a href="https://mapknitter.org/">MapKnitter</a></td>
    <td>Assemble aerial images into maps.</td>
    <td><a href="https://github.com/publiclab/mapknitter">github:publiclab/mapknitter</a></td>
</tr>
<tr>
    <td><a href="https://spectralworkbench.org/">Spectral Workbench</a></td>
    <td>Material analysis using DIY spectrometry.</td>
    <td><a href="https://github.com/publiclab/spectral-workbench">github:spectral-workbench</a></td>
</tr>
<tr>
    <td>Leaflet.Illustrate</td>
    <td>Leaflet plugin built for MapKnitter. Enables text annotations on Leaflet maps.</td>
    <td><a href="https://github.com/manleyjster/Leaflet.Illustrate">github:manleyjster/Leaflet.Illustrate</a></td>
</tr>
<tr>
    <td>Leaflet.DistortableImage</td>
    <td>Leaflet plugin built for MapKnitter. Enables images to be distorted.</td>
    <td><a href="https://github.com/publiclab/Leaflet.DistortableImage">github:publiclab/Leaflet.DistortableImage</a></td>
</tr>
<tr>
    <td><a href="http://infragram.org">Infragram</a></td>
    <td>Analyze plant health with infrared imagery.</td>
    <td><a href="https://github.com/p-v-o-s/infragram-js">github:p-v-o-s/infragram-js</a></td>
</tr>
<tr>
    <td>MapMill</td>
    <td>Upload and collaboratively rank large batches of aerial imagery.</td>
    <td><a href="https://github.com/publiclab/mapmill">github:publiclab/mapmill</a></td>
</tr>
</table>

Public Lab is on Github at: https://github.com/publiclab

## First time contributors

New to open source/free software? Here are some resources to get you started:

http://www.firsttimersonly.com/

http://www.charlotteis.co.uk/making-your-first-pull-request/

A very in-depth guide: https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github

https://guides.github.com/activities/contributing-to-open-source/

On our [PublicLab.org GitHub repository](https://github.com/publiclab/plots2), we've listed some "good for first timers" bugs to fix here: https://github.com/publiclab/plots2/labels/first-timers-only

We also have a slightly larger list of easy-ish but small and self contained issues: https://github.com/publiclab/plots2/labels/help-wanted

****

##Google Summer of Code

Lots of development on Public Lab software happens as part of the GSoC program, supported generously by Google. Looking at the [GSoC Ideas list](/wiki/gsoc-ideas) is a great place to find projects which our community really needs to get done, whether or not you're in the program. 

Read more at http://publiclab.org/wiki/gsoc, and review recent GSoC proposals/projects at http://publiclab.org/tag/gsoc


****

###Installation videos

####MapKnitter

<iframe width="853" height="480" src="https://www.youtube.com/embed/iGYGpS8rZMY?rel=0&amp;showinfo=0" frameborder="0" allowfullscreen></iframe>

****

##Simple installation with Cloud9

Cloud9, at http://c9.io, can be used to set up a complete development environment, for free, in the cloud -- including Git and a test suite, so you can make changes and create pull requests. These instructions are for PublicLab.org, but there are similar instructions available for Spectral Workbench and MapKnitter (coming soon). Each is listed in that project's README file:

1. If you have a GitHub account, visit https://c9.io and log in with the GitHub button.
2. Fork this repository to your own GitHub account, creating a `yourname/plots2` project. (or the corresponding project you're working on)
3. Name your project, then (order important!) choose the **Ruby** template, THEN enter `yourname/plots2` (or the corresponding project) in the "Clone from Git or Mercurial URL" field, and press **Create Workspace** 
4. In the command line prompt at the bottom of the page, type `./install_cloud9.sh` and press enter.
5. Enter your username when prompted, and click "Run Project" when it's done.
6. You're done! Go to the URL shown!


##Really basic Github contribution

There is a way to contribute to Public Lab software without using a command line or having any special computer or setup, as long as your changes are simple -- this works best for just changes to text or HTML, not executable code. You'll need a [Github account](https://github.com):

* Visit the repository (such as https://github.com/publiclab/plots2) you want to contribute to, and **fork it** with the button to the upper right. 
* Find the file you want to edit in your own fork. It'll be on a page (this won't exist until you fork) at a URL like `https://github.com/<yournamehere>/plots2/blob/master/app/views/layouts/_header.html.erb`, but you could navigate to it through Github's file browsing interface as well.
* Press the pencil button in the upper right:

![screenshot 2015-08-24 at 12 35 42 pm](https://cloud.githubusercontent.com/assets/24359/9445953/dcb535fa-4a5c-11e5-8f24-7937010bac53.png)

* Edit the code, then below, create a pull request with your new change (give it a name like 'yourname-header-tweaks'):

![screenshot 2015-08-24 at 12 37 53 pm](https://cloud.githubusercontent.com/assets/24359/9445973/04023928-4a5d-11e5-972e-b0cf7d4850bc.png)

At this point, we'll see your pull request, provide feedback, test it out, and hopefully integrate it. Things may get more complex, but this is a great starting point.