The Public Lab Developers group is an open mailing list for Public Lab related (or -interested) programmers and developers. Float ideas, solicit feedback, get involved in existing PL programming projects, or start your own! <--- Subscribe at left <--- ##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), then visit our [github dashboard:](https://github.com/publiclab/plots2/projects/2?fullscreen=true) [![Screen_Shot_2016-11-30_at_11.34.03_AM.png](https://publiclab.org/system/images/photos/000/018/942/large/Screen_Shot_2016-11-30_at_11.34.03_AM.png)](https://publiclab.org/system/images/photos/000/018/942/original/Screen_Shot_2016-11-30_at_11.34.03_AM.png) **** ##Activities: software [activities:software] **** ## Public Lab Software projects
Project Description Source Code
PublicLab.org This very website! github:publiclab/plots2
MapKnitter Assemble aerial images into maps. github:publiclab/mapknitter
Spectral Workbench Material analysis using DIY spectrometry. github:spectral-workbench
PublicLab.Editor A general purpose, JS/Bootstrap UI framework for rich text posting, with an author-friendly, minimal, mobile/desktop interface. github:publiclab/PublicLab.Editor
Leaflet.DistortableImage Leaflet plugin built for MapKnitter. Enables images to be distorted. github:publiclab/Leaflet.DistortableImage
Leaflet.Illustrate Leaflet plugin built for MapKnitter. Enables text annotations on Leaflet maps. github:manleyjster/Leaflet.Illustrate
WebJack a JavaScript library that uses an audio software modem to communicate with an Arduino via a headphone jack github:publiclab/webjack
Infragram Analyze plant health with infrared imagery. github:p-v-o-s/infragram-js
MapMill Upload and collaboratively rank large batches of aerial imagery. github:publiclab/mapmill
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 **** ### Contributing for non-coders Not interested (or not yet interested) in coding, but still want to help out? Have a project you really need to get your work done, and trying to encourage coders to tackle it? You can still help out; in fact, **helping to clearly describe and document problems and new feature proposals is at least as important as writing the code itself**. When creating or editing an issue, try to: 1. Clearly describe the problem, linking to pages where it can be observed, or where a new feature might live. Include screenshots to be very specific! 2. (for bugs) If you don't know the problem, do what you can to help others narrow it down: provide contextual information like your browser, OS, and what you were doing when it happened. Did it used to work? Does it still, but only sometimes? Help them reproduce it! 3. Propose a solution. Whether or not you code, describing what **should** or **could** happen, or even what you expected to happen is always helpful to someone looking to fix it. This can be as simple as "It should show a notification." or "There should be a way to hide it." Once an issue is well documented, we can tag it with `help-wanted` to get the word out that we're looking for someone to try to fix it. If you're not sure if it's ready, ask [on the plots-dev list](#Sign+up) Finally, if your issue is well documented, try to get involved in some outreach to new contributors to match someone with the project! Tell them what it'll help you achieve and why you'd appreciate help. And coordinate with the [plots-dev discussion list](#Sign+up) to get the word out. ### Preparing issues for newcomers Related to the above, even if you are a coder, we need help "rolling out the red carpet" (as the [Hoodie project](http://hood.ie) calls it) for new contribtors, to grow our contributor base. The steps in [Contributing for non-coders](#Contributing+for+non-coders) are a good starting point, but as a coder, you can also deep-link to the relevant lines of code, with Github links and pointers like: > Then the `:medium` in JavaScript on this line must be changed to `:large` too: https://github.com/publiclab/plots2/blob/master/app/assets/javascripts/dragdrop.js#L64 This is especially great for attracting coders who are not only new to our code, but new to coding in general! Learn more about how to make a good `first-timers-only` issue here: https://publiclab.org/notes/warren/10-31-2016/create-a-welcoming-first-timers-only-issue-to-invite-new-software-contributors **** ##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 **** ##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!