# 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](Grader-QuickStart.pdf)  
  *(See how an instructor would use Grader)*
- **Quick Student Guide**: [Grader-Student.pdf](Grader-Student.pdf)  
  *(Extra information and learning points for WAD students)*
- **Code Reference**: [Grader-Reference.pdf](Grader-Reference.pdf)  
  *(Fully cross-referenced source-code documentation with diagrams)*
- **Conference Paper**: [Grader-PublishedPaper.pdf](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.