Skip to content
Open
34 changes: 34 additions & 0 deletions staff/assignments/autograding.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,40 @@ The autograder system uses an "overlay grader" architecture that allows flexible

*Detailed documentation coming soon.*

## Empty Submission Detection

Pawtograder automatically detects empty submissions where students have not made meaningful changes to the starter code. When an empty submission is detected:

- The submission is flagged with a warning indicator
- Students are notified that their submission appears to be empty
- Instructors can see which submissions are empty in the grading interface

This helps identify students who may need assistance or who accidentally submitted without completing their work.

## Test Insights and Error Explorer

Pawtograder provides powerful tools to help instructors understand and address common test failures across student submissions.

### Error Explorer

The error explorer groups similar test failures together, making it easy to:

- Identify patterns in student errors
- See which students are affected by each error type
- View and copy affected students' email addresses for bulk communication
- Pin error groups globally to highlight common issues

### Regrade Workflow

When you need to regrade submissions after fixing test issues:

1. Launch a regrade directly from the error explorer
2. Submissions are automatically preselected on the autograder page
3. Choose to regrade from specific commits or enter a manual SHA
4. Option to auto-promote the new submission as the active submission

This streamlined workflow makes it easy to regrade multiple students who encountered the same issue, without manually selecting each submission.

## Quickstart: Java and Python

Build system integration guides for common programming languages.
Expand Down
15 changes: 15 additions & 0 deletions staff/assignments/handgrading.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,10 @@ Instructors can define multiple handgrading rubrics for each assignment, althoug

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).

<Note>
TAs can edit or delete rubric scores even after completing a review. This allows you to make corrections or adjustments without needing to "uncomplete" the review first.
</Note>

## Grading Submissions That You Have Been Assigned

When you have submissions assigned to grade, you will see a summary of them on the assignment's landing page.
Expand Down Expand Up @@ -41,3 +45,14 @@ By clicking on a student/group name, you will be taken to the grading interface
<Frame>
<img src="/images/staff/assignments/handgrading-1756060471440.png" alt="Individual submission grading interface" />
</Frame>

## Grading Status Dashboard

The grading status dashboard provides instructors with a comprehensive overview of grading progress across all assignments. Access it from the course navigation to see:

- **Completion status**: Track which submissions have been graded and which are pending
- **Grader assignments**: See which staff members are assigned to grade each submission
- **Progress metrics**: Monitor overall grading progress for each assignment
- **Due dates**: View grading task deadlines to ensure timely completion

This dashboard helps instructors identify bottlenecks, redistribute workload if needed, and ensure all submissions are graded before releasing results to students.
11 changes: 11 additions & 0 deletions staff/assignments/intro.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,3 +32,14 @@ Instructors can set a class-wide number of late tokens, and configure assignment
Each token can be exchanged for a 24-hour extension, but the extension must be requested before the student's original due date.

Instructors and graders can also manually grant extensions to students, and can view all extensions granted to a student. This is done in the assignment configuration under "Due Date Exceptions".

## Leaderboard

Assignments can optionally include a leaderboard to display student rankings based on autograder scores. The leaderboard feature:

- Shows top-performing submissions in real-time
- Can be enabled or disabled per assignment
- Helps reduce clutter when not needed for competitive assignments
- Encourages friendly competition when enabled

Instructors can toggle the leaderboard on or off in the assignment settings to match the pedagogical goals of each assignment.
10 changes: 10 additions & 0 deletions staff/discussion.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,16 @@ Posts can be shared with the entire class, or with course staff only. Each user

Students can edit their own posts, and staff can edit any post.

### Image Uploads

The discussion board supports drag-and-drop image uploads, making it easy to share:

- Screenshots of code or error messages
- Diagrams and visual explanations
- Assignment-related images

Simply drag an image file into the post editor or reply box, and it will be automatically uploaded and embedded in your post. This feature works for both creating new posts and replying to existing threads.

### Post Metadata

Each post displays:
Expand Down
31 changes: 30 additions & 1 deletion staff/office-hours/intro.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,36 @@ This ensures students never miss updates, even while browsing the discussion boa

## Resolving Requests

A help request can be marked as "Resolved" by either a staff member or a student.
A help request can be marked as "Resolved" by either a staff member or a student. Students can resolve their own requests from the chat interface or floating banner, and can select a resolution status:

- **Resolved - Got help**: Student received assistance and issue is resolved
- **Resolved - Figured it out**: Student solved the problem independently
- **Resolved - No longer needed**: Student no longer needs help

This resolution flow helps track the effectiveness of office hours and understand how students are getting their questions answered.

## AI Assistance for Staff

Pawtograder includes AI assistance tools to help instructors and TAs support students more effectively. When viewing a help request or discussion thread, staff can click the **AI Help** button to generate context that can be used with AI assistants.

The AI assistance system uses the Model Context Protocol (MCP) to provide:

- Access to help request details and chat history
- Student submission files and test results
- Build output and error messages
- Assignment context from handout URLs

<Note>
AI assistance is only available to instructors and graders. Student data is protected and never exposed through the AI tools.
</Note>

To use AI assistance:

1. Configure the MCP server with Supabase OAuth authentication
2. Click the **AI Help** button when viewing a help request or discussion thread
3. Use the generated context with any MCP-compatible AI client

This feature helps staff quickly understand student issues and provide more targeted assistance, especially when dealing with complex error messages or debugging scenarios.

## Feedback and Analytics

Expand Down
10 changes: 10 additions & 0 deletions students/discussion-board.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,16 @@ Click the **+ New Post** button in the top right to create a new discussion thre
3. **Select identity**: Post with your real name or pseudonym
4. **Mark as question or note**: Questions indicate you need an answer; notes are for sharing information

### Adding Images

You can easily add images to your posts and replies using drag-and-drop:

- Drag an image file directly into the post editor
- The image will be automatically uploaded and embedded
- Perfect for sharing screenshots, diagrams, or error messages

This works for both new posts and replies to existing threads.

## Engaging with Posts

Each post displays helpful metadata:
Expand Down
35 changes: 34 additions & 1 deletion students/office-hours.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,17 @@ Pawtograder's office hours feature allows students to request live help from cou

Students are encouraged to make public requests for help, so that other students can also benefit from the discussion.

## Get Help Button

A persistent **Get Help** button appears throughout the site, making it easy to request assistance from anywhere in the course. Click this button to:

- View the current office hours status
- See which queues are active and happening now
- Check the weekly queue schedule
- Submit a new help request

The help drawer shows live status updates and highlights queues that are currently staffed.

## Office Hours Queues

Instructors can create multiple office hours queues to provide different types of help. For example, if a class is coordinated across multiple campuses, there may be in-person help queues per-campus, and a cross-network virtual help queue.
Expand Down Expand Up @@ -86,6 +97,17 @@ Once you submit a help request:
Your active help request follows you around the site! You'll see status updates and video call notifications even while browsing the discussion board or other pages.
</Tip>

## Notifications

Pawtograder provides rich notifications to keep you informed about your help requests:

- **Browser notifications**: Desktop notifications when staff responds or starts helping you
- **Title notifications**: The page title updates to show new messages
- **Sound alerts**: Optional audio notifications for important updates
- **Favicon badge**: Visual indicator when you have unread messages

You can test notifications and manage permissions from the office hours page. Make sure to allow browser notifications for the best experience.

## Help Request Status

Your help request will show different statuses:
Expand All @@ -94,4 +116,15 @@ Your help request will show different statuses:
- **In Progress**: A staff member is actively helping you
- **Resolved**: Your request has been marked as complete

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.
## Resolving Your Help Request

When you're ready to close your help request, you can resolve it yourself:

1. Click the **Resolve** button in the help request chat or from the floating banner
2. Select a resolution status that best describes the outcome:
- **Resolved - Got help**: You received assistance and your issue is resolved
- **Resolved - Figured it out**: You solved the problem on your own
- **Resolved - No longer needed**: You no longer need help with this issue
3. Optionally provide feedback on the assistance you received

This feedback is visible only to instructors and helps improve the office hours experience. Staff members can also mark requests as resolved on your behalf.