[[TOC]]

= Grace Hopper Celebration Open Source Day Codeathon for Humanity 2012 =

The [http://systers.org/systers-dev/doku.php/ghc12osd/ Codeathon] at [http://gracehopper.org/2012/conference/grace-hopper-open-source-day/ GHC 2012] is intended to introduce participants to rapid development of FOSS applications in a collective coding setting.

== Ready, set, go! ==

=== Install the Eden development kit ===

We'd like to encourage all those intending to participate with the Sahana Software Foundation at the Grace Hopper Celebration Open Source Day to get started in advance by installing a developer's environment on their computer prior to the event (though this is **not** required - we will be prepared to get new contributors started from the beginning at the event).  We will be bringing USB sticks to the GHC conference with a complete developer's environment installation package and will be posting a link to download with instructions here prior to the event.  Please visit the Open Source booth at the conference when you arrive.

But it is never too early to get started.  Anyone wishing to work on Sahana Eden at the GHC Open Source Day Codeathon should look at our developer’s page for instructions on how to set up a developer’s environment, review our developer’s guidelines, and connect to our community here: [[Develop]]

'''Coming soon''':  Links and instructions to download and install a developer's environment that we will be using for the 2012 GHC Open Source Day!
=== Get an account on Github ===

''If you're in a hurry to get on with things, you can leave this til later, when you're ready to upload something to Github.''

Otherwise, please visit: DeveloperGuidelines/Git

=== Sign a Contributor License Agreement ===

The Sahana Software Foundation requires a [http://wiki.sahanafoundation.org/doku.php/foundation:start#contributor_license_agreement contributor license agreement] from anyone contributing code to the Sahana codebases.  This is a simple agreement that ensures our enduring right to redistribute any code you may have written without restriction.  You may [http://wiki.sahanafoundation.org/lib/exe/fetch.php/foundation:ssf_cla.pdf download] and return a form prior to the event or complete a paper copy at the Open Source Day.  You may still participate with Sahana even if you do not wish to sign a CLA, but we will not be able to merge any code patches you submit for integration with our project.

=== The IRC channel ===

We're going to take over the Eden IRC channel: #sahana-eden on freenode. If you don't already have an IRC client, the easiest way to connect is to use freenode's [[https://webchat.freenode.net| web chat client]].
* To post a message, type in the text box, type Enter.
* To get someone's attention, type their nick anywhere in your message. (Use sparingly -- this will ring bells / flash lights on their machine.)

Feel free to introduce yourself to the community **now** before GHC Open Source Day begins

=== Need Help? ===

If you have questions about setting up a Sahana Eden developer's environment or about working with the Sahana Software Foundation at the Grace Hopper Open Source Day or anything else related to the event, please feel free to contact ghc [at] sahanafoundation [dot] org. 
== Codeathon Project: Transport Module ==

We're going to be building a **Transport Module** in Sahana Eden based on the specifications and requirements provided by the [[http://www.cdema.org| Caribbean Disaster Emergency Management Agency]].  This will serve as a repository of airport, seaport, border crossing and other critical logistical information needed by the 18 member nations of CDEMA. For more information see BluePrint/Transport.

The Caribbean is prone to a number of natural hazards, particularly hurricanes during the annual Atlantic hurricane season.  CDEMA is responsible for coordinating disaster preparedness and response activities across 18 member states.  Sahana Eden has been selected to form the core of their Regional Logistics Tool that will be used to manage the provision of disaster relief supplies throughout the Caribbean.  This is particularly challenging as multiple air and sea routes must be understood.

Work will likely be accomplished in teams or pairs working together on elements of building the transport module.

=== Alternative Projects ===

Sahana Eden has tasks for persons with a range of skills. Those with some working knowledge of the Python programming language will be able to easily get started working on Sahana Eden to contribute to bug fixes or feature enhancement. Those with advanced Python skills can consider customization or developing new modules. Database design and SQL skills are also useful. 

For those wishing to work on Sahana Eden independently of the facilitated task of working on the Transport Module, we maintain lists of tasks for new contributors to work on.  These may be found on our Eden wiki on our main projects page at [[Projects]]. There are listed projects in several categories, including:

  * [[Projects/Non-Coding| non-coding projects]]
  * [[Project/Populate| Populate a database]] 
  * [[Projects/Design| design projects]]
  * [[Projects/Infrastructure| infrastructure projects]]
  * [[Projects/Basic| basic coding projects]]
  * [[Projects/Advanced| advanced coding projects]]

The non-coding and basic coding projects are usually most appropriate for tackling during events like codeathons.

=== Comments ===

* From Louiqa:
 * What to do when you cannot login?
  * If using the current/old VM then 'git pull;clean'
 * There is a directory /home/dev/eden and also /home/dev/web2py/applications/eden so which one should we use?
  * these are identical - 1 is a symlink to the other