The "One and Done" initiative, previously known as "QA Taskboard", is a workflow where Mozilla community contributors can pick tasks and work on them - one at a time, one day at a time - and feel good about doing them.

One and Done is written with Playdoh and Django.

If you're interested in helping us out, please read through the blog post and reach out to us!

These instructions assume you have git, python, and pip installed. If you don't have pip installed, you can install it with easy_install pip.

1. Start by getting the source:

   $ git clone --recursive git@github.com:mozilla/oneanddone.git
   $ cd oneanddone

   Note you may want to fork and clone the repo as described in the github docs if you are doing active development.

2. Create a virtualenv for One and Done. Skip the first step if you already have virtualenv installed.

   $ pip install virtualenv
   $ virtualenv venv
   $ source venv/bin/activate

3. Install the compiled requirements:

   $ pip install -r requirements/compiled.txt

4. Set up a local MySQL database. The MySQL Installation Documentation explains how to do this. Make sure your DB is utf8.

5. Configure your local settings by copying oneanddone/settings/local.py-dist to oneanddone/settings/local.py and customizing the settings in it:

   $ cp settings/local.py-dist settings/local.py

   The file is commented to explain what each setting does and how to customize them.

6. Initialize your database structure:

   $ python manage.py syncdb

You can launch the development server like so:

$ python manage.py runserver

This software is licensed under the Mozilla Public License v. 2.0_. For more information, read the file LICENSE.

.. _Mozilla Public License v. 2.0: http://mozilla.org/MPL/2.0/