ravenx447l / expertiza

Expertiza is a web application where students can submit and peer-review learning objects (articles, code, web sites, etc). The Expertiza project is supported by the National Science Foundation.

Expertiza

Peer review system

Expertiza is a web application where students can submit and peer-review learning objects (articles, code, web sites, etc). It is used in select courses at NC State and by professors at several other colleges and universities.

Setup

NCSU VCL image

The expertiza environment is already set up in NC State's VCL image "Ruby on Rails". If you have access, this is quickest way to get a development environment running for Expertiza.

If not:

Tools

• Set up git
• Install Ruby 1.8.7. (Some plugins/gems we use are not yet 1.9.2 compatible) On Linux/OSX, use rvm. On Windows, use RubyInstaller and RailsInstaller.
• gem install bundler (see issues on Windows)

Dependencies

• libxslt development libraries [OSX: (already installed?) Ubuntu: sudo apt-get install libxslt-dev Fedora: yum install libxslt-devel Windows: ?]
• libmysqlclient [OSX: brew install mysql Ubuntu: sudo apt-get install mysql-server mysql-client libmysqlclient-dev Fedora: yum install mysql mysql-server mysql-devel]
• (optional) graphviz
• bundled gems: bundle install

If anything is missing here, please report it in an issue or fix it in a pull request. Thanks!

Contributing

• Fork the expertiza project
• Create a new branch for your contribution with a descriptive name
• Commit and push until you are happy with your contribution - follow the style guidelines below
• Make sure to add tests for it; the tests should fail before your contribution/fix and pass afterward
• Send a pull request to have your code reviewed for merging back into Expertiza

Style Guidelines

We've had many contributors in the past who have used a wide variety of ruby coding styles. It's a mess, and we're trying to unify it.

All new files/contributions should:

• Use unix line endings (Windows users: configure git to use autocrlf)
• Indent with 2 spaces (no tabs; configure your editor) both in ruby and erb
• Follow the Ruby Style Guide style for syntax, formatting, and naming

When editing existing files:

• Keep the existing tabbing (use tabs instead of spaces in files that already use tabs everywhere; otherwise use spaces)
• Keep the existing line ending style (dos/unix)
• Follow the Ruby style Guide on code you add or edit, as above

Please do no go crazy changing old code to match these guidelines; it will just create lots of potential merge conflicts. Applying style guidelines to code you add and modify is good enough. :-)