X-Git-Url: https://projects.mako.cc/source/selectricity/blobdiff_plain/d06c024c7dddeca27c658b668ed313f3f107d2e6..cfe645440c51b66c088f19e84de650f026cf77f5:/README?ds=sidebyside diff --git a/README b/README index 859f0ca..f54d672 100644 --- a/README +++ b/README @@ -2,34 +2,48 @@ === Getting Selectricity ====================== =============================================== -Selectricity is free software and is distributed under the MIT or -BSD-like ExPat license. You are free to use, modify, and distribute, or -rework Selectricity. Of course, we'd sure like it if you would send -fixes back to us and tell us about cool stuff you do with our software! +Selectricity is free software and is distributed under the GNU Affero +General Public License version 3. You are free to use, modify, and +distribute, or rework Selectricity under the terms of that license. Of +course, we'd sure like it if you would send fixes back to us and tell us +about cool stuff you do with our software! The best way to get Selectricity is just to download it from our source -source repository. You'll need the Bazaar version control system or -source control manager to check it. You can get it here: +tree. At the moment, we're hosting our code at Gitorious which is a +free software hosting provider. You can download Gitorious at the +project page by following detailed instructions at Gitorious: - http://bazaar-vcs.org + http://gitorious.org/selectricity -Once you have it, getting the source code is pretty easy. You just need -to check out a branch with a command like this: - bzr branch http://projects.mako.cc/source/selectricity +=============================================== +=== Getting Help and Contributing ============= +=============================================== + +If you have a question, you can always email the core team at: + + team@selectricity.org + +If you want to get involved in development, want to discuss +selectricity, or want to participate, please subscribe to our mailing +list here: -This will give you the latest *development* version of our code. If you -want the latest production version (i.e., what we're running on the -site), you can grab that here: + http://mailman.mit.edu/mailman/listinfo/selectricity + +In terms of bugs and documentation, we current plan to build this out in +our Gitorious wiki so feel free to get started with your own efforts +along these lines there: + + http://gitorious.org/selectricity/pages/Home - bzr branch http://projects.mako.cc/source/selectricity-live =============================================== === Dependencies ============================== =============================================== To use Selectricity, you'll need to install the following gems in -addition to Ruby on Rails, MySQL, and its dependencies: +addition to Ruby on Rails (gem:rails), MySQL (gem:mysql), and its +dependencies: * rmagick * gruff (http://nubyonrails.com/pages/gruff) @@ -45,11 +59,17 @@ Also, you will need install the other applications installed first: * imagemagick (http://www.imagemagick.org/) On Ubuntu, you can install install the dependencies with: - apt-get install imagemagick libmagick9-dev ruby1.8-dev libwmf-bin + apt-get install imagemagick libmagick9-dev ruby1.8-dev libwmf-bin rdoc \ + libopenssl-ruby1.8 libreadline-ruby1.8 libmysqlclient15-dev Our server configuration uses Mongrel (installed from gems) behind an Apache2 load balancing proxy using mod_proxy. +You'll also need to have a MTA installed. We use Postfix and have not +tried it with any other system. Presumably though, anything that +provides '/usr/bin/sendmail' should work. + + =============================================== === Contributors to Selectricity Include ====== @@ -59,27 +79,4 @@ Apache2 load balancing proxy using mod_proxy. * John Dong * Justin Sharps -===================================== -=== XML-RPC INFO == -====================================== - -The XML-RPC API is still under development, but is somewhat functional already: - -To instantiate a client in Ruby, try something like: -client=ActionWebService::Client::XmlRpc.new(SelectricityAPI,"http://localhost:3000/selectricity_service/vote") - - -Getting the results of a quickvote is quite simple: -?> client.get_quickvote_results("test") -=> # - -Casting a quickvote: -client.cast_quickvote("test",1,[[1,2]]) - -To figure out what you're voting for: ->> client.get_quickvote_candidate_map("test")=> # - - - -