reidka edited this page Apr 27, 2016 · 15 revisions
Clone this wiki locally

Welcome to MarkUs

MarkUs is a web application for the submission and grading of student programming assignment. The primary purpose of MarkUs is to provide TAs with simple tools that will help them to give high quality feedback to students. MarkUs also provides a straight-forward interface for students to submit their work, form groups, and receive feedback. The administrative interface allows instructors to manage groups, organize the grading, and release grades to students.

Since 2008, more than 120 undergraduate students have participated in the development of MarkUs; some as full-time summer interns, but most working part time on MarkUs as a project course. The fact that we have have uncovered so few major bugs, and that MarkUs has been so well-received by instructors is a testament to the high quality work of these students. MarkUs is used in more than a dozen courses at the University of Toronto, in several courses at the University of Waterloo, and at École Centrale Nantes (in French).

MarkUs is written using Ruby on Rails, and uses Subversion (with a Git back-end in progress) to store the student submissions.

MarkUs Users

Users may also find the Sandbox useful.

Developer Resources

If you are interested in contributing to MarkUs, there is lots of information below to help you get set up. Please help us keep this documentation up to date!

The Developer's Blog has quite a few useful posts to help you get started or understand design decisions that were made along the way. It also includes status reports from various terms.

Project communication:

Most of the low-level technical discussion takes place on the Issue list and in Code Reviews. There is a guide to creating MarkUs Code Reviews.

Getting started:

MarkUs is a Ruby on Rails application. Thanks to various dependencies and the fact that all the current production servers run on Linux servers, all development is done on Linux. Because virtual machines are easy to install, this has become the most popular option.

We have never had success getting a development environment installed on Windows, and more recently we have not been able to compile subversion ruby bindings on OSX, leaving Linux as the only development environment.

You have two main options. The first is to use vagrant to download a pre-configured virtual machine that has most of the required software installed on it. The second is to set up your own virtual machine. You should follow one of the the two installation guides below.

After you have installed the primary software components, it is time to get the MarkUs source code and configure it.

Setting up MarkUs

Git Resources

Old Screencasts

Project Contributors

Aaron Lee, Abdelhamid Benmouffok, Adam Goucher, Aimen Khan, Alessio Di Sandro, Alexander Kittelberger, Alexandre Lissy, Alexandre Vaillancourt, Alex Clarke, Alex Grenier, Alex Inman, Alex Krassikov, Alysha Kwok, Amanda Manarin, Andrew Hernandez, Andrew Louis, Andrey Kulakevich, Angelo Maralit, Ante Zheng, Anthony Labaere, Anthony Le Jallé, Anton Braverman, Arianne Dee, Augustin Doury, Benjamin Thorent, Benjamin Vialle, Bertan Guven, Binuri Walpitagamage, Brian Bo, Brian Xu, Bryan Muscedere, Bryan Shen, Camille Guérin, Catherine Fawcett, Chris Kellendonk, Christian Garcia Salguero, Christian Jacques, Christian Millar, Christine Murad, Christine Yu, Christopher Jonathan, Christopher Koehler, Claire Mayer, Clément Delafargue, Clément Schiano, Danesh Dadachanji, Daniel St. Jules, Daniyal Liaqat, Daryn Lam, David Das, David Liu, Derek Dowling, Diane Tam, Dina Sabie, Dmitry Khabarov, Dylan Runkel, Ealona Shmoel, Egor Philippov, Emerik Morency, Erik Traikov, Eugene Cheung, Evan Browning, Farah Juma, Fernando Garces, François Neber, Gabriel Roy-Lortie, Gaëtan Girin, Geoffrey Flores, Ghislain Guiot, Gillian Chesnais, Hanson Wu, Haohan David Jiang, Horatiu Halmaghi, Ian Smith, Ibrahim Shahin, Irene Fung, Isabelle Chan, Ishan Thukral, Jakub Subczynski, Jay Parekh, Jeffrey Ling, Jeremy Goh, Jeremy Merkur, Jeremy Winter, Jérôme Gazel, Jesse Cordeiro, Jiahui Xu, Joel Burford, Joey Perry, Jordan Saleh, Joseph Mate, Joseph Maté, Joshua Dyck, Joshua Smith, Julien Starozinski, Junghwan Tom Choi, Justin Foong, Karel Kahula, Kevin MacPhee, Kira McCoan, Kitiya Srisukvatananan, Kristian Lejao, Kurtis Schmidt, Lawrence Wu, Loïc Labagnara, Luke Kysow, Marc Bodmer, Marc Palermo, Mark Kazakevich, Mark Rada, Maryna Moskalenko, Mélanie Gaudet, Melissa Neubert, Michael Ing, Michael Lumbroso, Michael Margel, Mike Conley, Mike Gunderloy, Mike Stewart, Mike Wu, Mina Almasry, Misa Sakamoto, Nathan ChowNeha Kumar, Neha Kumar, Nelle Varoquaux, Nicholas Maraston, Nick Lee, Nicolas Bouillon, Nicolas Carougeau, Noé Bedetti, Oloruntobi Ogunbiyi, Ope Akanji, Oussama Ben Amar, Paymahn Moghadasian, Peter Guanjie Zhao, Rafael Padilha, Razvan Vlaicu, Rebecca Frailich, Robert Burke, Ryan Spring, Samuel Gougeon, Sean Budning, Severin Gehwolf, Shaughn Finnerty, Shenglong Gao, Shion Kashimura, Simon Lavigne-Giroux, Stephen Tsimicalis, Su Zhang, Tara Clark, Tiago Chedraoui Silva, Tianhai Hu, Valentin Roger, Veronica Wong, Victoria Mui, Victoria Verlysdonk, Victor Ivri, Vivien Suen, William Kwan, William Roy, Wilson Chiang, Xiang Yu, Yansong Zang, Yusi Fan, Zachary Munro-Cape

Supervisors: Karen Reid, David Liu, Morgan Magnin, Benjamin Vialle

Term Work

Status Reports:

Everything a Developer Needs to Know about Ruby, Ruby on Rails and MarkUs

MarkUs Deployment Documents

Installation Instructions for MarkUs using RAILS_ENV=production

For a complete list of local wiki pages, see TitleIndex.