diff --git a/staff/assignments/autograding.mdx b/staff/assignments/autograding.mdx index dde886a..65cf7fb 100644 --- a/staff/assignments/autograding.mdx +++ b/staff/assignments/autograding.mdx @@ -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. diff --git a/staff/assignments/grading-assignments.mdx b/staff/assignments/grading-assignments.mdx index d667820..6dde0ae 100644 --- a/staff/assignments/grading-assignments.mdx +++ b/staff/assignments/grading-assignments.mdx @@ -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 diff --git a/staff/assignments/handgrading.mdx b/staff/assignments/handgrading.mdx index 3c0f74c..494cf5b 100644 --- a/staff/assignments/handgrading.mdx +++ b/staff/assignments/handgrading.mdx @@ -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 diff --git a/staff/assignments/intro.mdx b/staff/assignments/intro.mdx index 6278bec..5db70d1 100644 --- a/staff/assignments/intro.mdx +++ b/staff/assignments/intro.mdx @@ -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. diff --git a/staff/office-hours/intro.mdx b/staff/office-hours/intro.mdx index 43b2311..5d53cfd 100644 --- a/staff/office-hours/intro.mdx +++ b/staff/office-hours/intro.mdx @@ -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. diff --git a/students/assignments/create-submission.mdx b/students/assignments/create-submission.mdx index 09500b4..a4d22e0 100644 --- a/students/assignments/create-submission.mdx +++ b/students/assignments/create-submission.mdx @@ -19,7 +19,7 @@ Every time that you push changes to your repository, Pawtograder will automatica Submission page showing autograder results and grading rubric preview -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. Files tab displaying submitted code files diff --git a/students/office-hours.mdx b/students/office-hours.mdx index 9e6e241..14c271f 100644 --- a/students/office-hours.mdx +++ b/students/office-hours.mdx @@ -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.