Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions staff/assignments/autograding.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,17 @@ The autograder system uses an "overlay grader" architecture that allows flexible

*Detailed documentation coming soon.*

## Test Insights and Error Explorer

Pawtograder provides powerful test insights to help instructors identify and address common student errors:

- **Error Explorer**: View grouped test failures across all submissions to identify patterns
- **Regrade Workflow**: Launch regrading directly from the error explorer with preselected submissions
- **Email Export**: View and copy affected students' emails from error groups for targeted communication
- **Flexible Regrade Options**: Choose specific commits or manual SHA in a regrade dialog with auto-promote functionality

These tools help instructors quickly identify widespread issues and efficiently regrade submissions when autograder configurations are updated.

## Quickstart: Java and Python

Build system integration guides for common programming languages.
Expand Down
2 changes: 1 addition & 1 deletion staff/assignments/grading-assignments.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ icon: "users-gear"

# Assigning Grading Tasks

Pawtograder has a robust feature to allow instructors to assign grading tasks to staff. When a grading task is assigned, the instructor can set a due date for that task, and re-assign the task to a different grader if needed. Pawtograder will also automatically allow any other grader to complete the task if the original grader is unable to complete it (without needing to re-assign the task).
Pawtograder has a robust feature to allow instructors to assign grading tasks to staff. When a grading task is assigned, the instructor can set a due date for that task, and re-assign the task to a different grader if needed. When reassigning a rubric part to a TA who already completed grading a different rubric part for the same submission, the new work will appear in their pending work list. Pawtograder will also automatically allow any other grader to complete the task if the original grader is unable to complete it (without needing to re-assign the task).

## Conflicts of Interest

Expand Down
13 changes: 12 additions & 1 deletion staff/assignments/handgrading.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,18 @@ icon: "pen-to-square"

Instructors can define multiple handgrading rubrics for each assignment, although the most typical mechanism is to simply use the "Grading Rubric" (which, combined with the autograder score, is used to compute the score for each submission).

Once all required rubric checks are done, the grader can click the "Complete Review" button to confirm that they have completed grading. This does **not** release the review to the student, but indicates to the instructor that it **could** be released (at the instructor's discretion).
Once all required rubric checks are done, the grader can click the "Complete Review" button to confirm that they have completed grading. This does **not** release the review to the student, but indicates to the instructor that it **could** be released (at the instructor's discretion). TAs can edit or delete rubric scores even after completing a review, allowing for corrections and adjustments as needed.

## Grading Status Dashboard

The assignment landing page provides a comprehensive grading status dashboard that shows:

- Overall grading progress across all submissions
- Individual grader workload and completion status
- Pending grading tasks organized by grader
- Quick access to ungraded submissions

This dashboard helps instructors monitor grading progress and ensure balanced workload distribution among TAs.

## Grading Submissions That You Have Been Assigned

Expand Down
4 changes: 4 additions & 0 deletions staff/assignments/intro.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,10 @@ Assignments can be individual, group-optional, or group-required.
Students can be assigned to groups by instructors, or can self-assign to groups.
Instructors can reuse a set of groups from a prior assignment.

## Empty Submission Detection

Pawtograder automatically detects empty submissions to help identify students who may need assistance. When a submission contains no meaningful content, it is flagged for instructor review, making it easier to reach out to students who might be struggling with the assignment.

## Due Date Exceptions

Instructors can set a class-wide number of late tokens, and configure assignments to allow students to use those tokens as desired.
Expand Down
12 changes: 12 additions & 0 deletions staff/office-hours/intro.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -65,6 +65,18 @@ When a student has an active help request, it follows them around the site. They

This ensures students never miss updates, even while browsing the discussion board or other course pages.

### AI Assistance for Instructors

Pawtograder includes a Model Context Protocol (MCP) server that enables AI assistants to help instructors and TAs support students who are struggling with errors in their programming assignments. The MCP server provides:

- Secure Supabase OAuth authentication (instructors and graders only)
- Tools for fetching help requests, discussion threads, submissions, test results, and build output
- Privacy protection that never exposes sensitive user data
- AI Help button in help request chat and discussion thread views
- Support for any MCP-compatible AI client

To use AI assistance, instructors can add a handout URL to assignments (in the assignment configuration) to provide assignment context to AI assistants. The AI Help button generates MCP context that can be used to help diagnose student issues and provide targeted assistance.

## Resolving Requests

A help request can be marked as "Resolved" by either a staff member or a student.
Expand Down
2 changes: 1 addition & 1 deletion students/assignments/create-submission.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Every time that you push changes to your repository, Pawtograder will automatica
<img src="/images/students/assignments/create-submission-1754510547128.png" alt="Submission page showing autograder results and grading rubric preview" />
</Frame>

The "Files" tab shows the files that your instructor configured for the submission.
The "Files" tab shows the files that your instructor configured for the submission. Binary files (such as images, PDFs, and compiled files) are supported and can be downloaded. Markdown files (.md) are rendered with syntax highlighting for easy reading.

<Frame>
<img src="/images/students/assignments/create-submission-1754510607368.png" alt="Files tab displaying submitted code files" />
Expand Down
4 changes: 4 additions & 0 deletions students/office-hours.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -94,4 +94,8 @@ Your help request will show different statuses:
- **In Progress**: A staff member is actively helping you
- **Resolved**: Your request has been marked as complete

## Resolving Your Help Request

When you're ready to close your help request, you can resolve it yourself from the floating banner or main chat view. You'll be able to select a resolution status to indicate how your issue was resolved, which helps instructors understand the effectiveness of office hours support.

After receiving help, you can provide feedback on the assistance you received. This feedback is visible only to instructors and helps improve the office hours experience.