Student Alliance Elections System
Latest Version: v0.2.0-beta
Student Alliance Elections System is a voting system for the Student Alliance elections of PSHS-EVC. The voting system is a web app built using Django.
NOTE: SAElections uses Python 3.4 and Django 1.8.
Setting Up SAElections In Your Local Machine
At the moment, development in Linux is only supported. Should one find out that the methodology below works on other platforms, feel free to update this README and do a pull request (See Contributing).
The instructions below assume that you already have Git, pip, and virtualenv installed. Please refer to your distribution's documentation for installing the required packages in your system.
Download a zipped copy of SAElections or type the following command in the Terminal.
git clone https://github.com/seanballais/SAElections.git
In the Terminal, extract the ZIP file if you downloaded a zipped copy and then go to the directory where you extracted or cloned SAElections.
Once inside the directory, type the following commands.
source venv/bin/activate ./SAElections/manage.py runserver
You are done! To access the web site, open your browser and go to
http://localhost:8000. Have fun!
Contributing to SAElections is encouraged to create better software and help you gain experience. Even forking this project to create your own version is highly encouraged as long as you comply with the project's license. See License.
To start contributing, follow the steps below. It is assumed that Git, pip, and virtualenv are already installed in your system.
For the time being, only instructions for contributing in a Linux system is available. This is a great contribution opportunity if you are contributing in a different platform.
- Fork this repo.
- Clone your repo in your system.
- Make sure to
git checkout developto get the latest code.
- Make changes to the code.
- Rebase your code from this repo to get the latest changes.
- Make sure your code does not conflict with this repo's code and works properly.
- Commit your changes and make a pull request.
- You are done! Congratulations! Wait for responses regarding your pull request.
Your code will be subjected to tested and code review to make sure your code works, and is consistent with the coding style. The coding style document will still be written. Hey, another contribution opportunity!
Copyright © 2015. All Rights Reserved. Sean Francis N. Ballais.