Starter Page

Grader: Readme File

Overview

Grader is designed to make the logistical part of grading WAD lab tests seamless and efficient, while also enhancing the student learning experience through personalized feedback. Here are its core features:

  • Validating files uploaded by students to ensure correct structure and completeness.
  • Displaying submitted files directly in the grading interface for easy review.
  • Rubric-based grading with rubrics displayed alongside each file, enabling consistent and transparent evaluation.
  • Attaching personalized comments to graded files for individualized feedback.
  • Running auto-graders in batch to automatically assess selected parts of the student submissions.
  • Generating detailed feedback reports for students, combining instructor comments and auto-grader outputs.
  • Emailing personalized grading feedback to each student efficiently.
  • Supporting instructors with a streamlined grading workflow, reducing manual effort and errors.
  • And much more.

Since this version is intended for students, you will not be grading anyone. Instead, you can explore Grader using included sample files. It offers you students a view of the grading system in action, using sample files and documentation, which includes:

  • Viewing how instructors use Grader through a Quick Start Guide that walks through the entire grading workflow.
  • Understanding the design and internals of Grader via a conference paper, which outlines the purpose, design principles, and early development version of Grader.
  • Referencing the complete codebase with fully cross-referenced source code documentation generated using Doxygen, including class relationships and diagrams for in-depth understanding.
  • Hands-on exploration without grading responsibility — since this student version is designed for learning and experimentation.
  • And get inspired.

Reference Materials

The following files are available in this folder:

  • Quick Start Guide: Grader-QuickStart.pdf
    (See how an instructor would use Grader)
  • Quick Student Guide: Grader-Student.pdf
    (Extra information and learning points for WAD students)
  • Code Reference: Grader-Reference.pdf
    (Fully cross-referenced source-code documentation with diagrams)
  • Conference Paper: Grader-PublishedPaper.pdf
    (Details the design and purpose of Grader, presented at EDUCON 2024 in Greece — note that it describes an earlier version)

Quick Start

  1. Unzip Grader.zip to your Document Root (e.g., /Applications/MAMP/htdocs/ for MAMP on macOS).
  2. Open http://localhost/Grader/index.php in your browser.
  3. Follow the online documentation to explore Grader’s functionalities.