Pull request for mintlify/docs-update-1769288448901

docs.json

@@ -26,7 +26,8 @@
               "students/assignments/create-submission",
               "students/assignments/form-groups",
               "students/assignments/late-tokens",
-              "students/assignments/self-review"
+              "students/assignments/self-review",
+              "students/assignments/leaderboard"
             ]
           },
           {
@@ -51,10 +52,15 @@
             "group": "Assignments",
             "pages": [
               "staff/assignments/intro",
+              "staff/assignments/assignment-dashboard",
+              "staff/assignments/grading-dashboard",
+              "staff/assignments/test-insights",
+              "staff/assignments/security-dashboard",
               "staff/assignments/grading-assignments",
               "staff/assignments/handgrading",
               "staff/assignments/autograding",
               "staff/assignments/rubrics",
+              "staff/assignments/extensions-and-scoring",
               "staff/assignments/testing"
             ]
           },

staff/assignments/assignment-dashboard.mdx

@@ -0,0 +1,100 @@
+---
+title: "Assignment Dashboard"
+description: "Get a comprehensive overview of assignment status, submissions, and student progress"
+---
+
+# Assignment Dashboard
+
+The assignment dashboard provides a centralized view of all key metrics and information for an assignment. Use this dashboard to monitor student progress, track submissions, and manage assignment logistics.
+
+## Accessing the Dashboard
+
+Navigate to any assignment to view its dashboard. The dashboard is the default landing page for each assignment.
+
+## Dashboard Components
+
+### Assignment Overview
+
+The top section displays essential assignment information:
+
+- **Assignment name and description**
+- **Due date and time**
+- **Release status**: Whether the assignment is visible to students
+- **Submission count**: Number of students who have submitted
+
+### Submission Statistics
+
+Track student progress with real-time statistics:
+
+- **Total submissions**: How many students have submitted work
+- **Pending submissions**: Students who haven't submitted yet
+- **On-time vs. late**: Breakdown of submission timing
+- **Average score**: Current average across all graded submissions
+
+### Quick Actions
+
+Access common assignment management tasks:
+
+- **View all submissions**: Navigate to the submissions list
+- **Manage grading**: Assign grading tasks to staff
+- **Edit assignment**: Modify assignment settings
+- **View test insights**: Access the test insights dashboard
+- **Check security**: Open the security dashboard
+
+### Recent Activity
+
+See the latest updates and actions:
+
+- Recent submissions
+- Grading completions
+- Student questions or issues
+- System notifications
+
+## Grading Progress
+
+Monitor grading status across all submissions:
+
+- **Graded**: Submissions with completed reviews
+- **In progress**: Submissions currently being graded
+- **Not started**: Submissions awaiting grading assignment
+
+### Grader Workload
+
+View grading distribution across your staff:
+
+- Which graders are assigned to which submissions
+- Completion rates per grader
+- Overdue grading tasks
+
+## Student Engagement Metrics
+
+Track how students are engaging with the assignment:
+
+- **Repository activity**: Commit frequency and timing
+- **Autograder runs**: How often students are testing their code
+- **Help requests**: Office hours requests related to this assignment
+- **Discussion posts**: Questions and discussions about the assignment
+
+## Filtering and Sorting
+
+Customize your dashboard view:
+
+- Filter by submission status (submitted, pending, late)
+- Sort by score, submission time, or student name
+- Search for specific students
+- Group by section or team (for group assignments)
+
+<Tip>
+Check the assignment dashboard regularly to identify students who may need additional support or to spot trends in common issues.
+</Tip>
+
+## Exporting Data
+
+Export assignment data for further analysis:
+
+- Submission reports
+- Grading summaries
+- Student progress data
+- Autograder results
+
+Use the export functionality to generate reports for department records or to analyze assignment effectiveness.

staff/assignments/autograding.mdx

@@ -16,6 +16,44 @@ The autograder system uses an "overlay grader" architecture that allows flexible
 
 *Detailed documentation coming soon.*
 
+## Rerunning the Autograder
+
+You can rerun the autograder on existing submissions to apply updated grading logic or fix issues. The enhanced rerun feature provides more control over the regrading process.
+
+### Rerun Options
+
+When rerunning the autograder, you can:
+
+1. **Reuse existing submissions**: The autograder reruns on the same submission without creating a new one
+2. **Select grader version**: Choose which version of the grader to use for the rerun
+   - Select from recent commits in your grader repository
+   - Enter a specific commit SHA manually
+   - Use the current active grader version
+
+### How to Rerun
+
+To rerun the autograder on submissions:
+
+1. Navigate to the assignment's autograder page
+2. Select the submissions you want to regrade
+3. Click the "Rerun Autograder" button
+4. In the regrade dialog:
+   - Choose a grader version from the commit list, or
+   - Enter a specific commit SHA
+   - Optionally enable "Auto-promote" to set this version as the active grader
+
+### Auto-Promote Feature
+
+The auto-promote option automatically promotes the selected grader version to be the active grader for all future submissions after the rerun completes successfully. This is useful when:
+
+- You've fixed a bug in the grader and want to apply it going forward
+- You've updated test cases and want all new submissions to use them
+- You're confident the new grader version should be the default
+
+<Warning>
+Rerunning the autograder will replace the existing autograder results for the selected submissions. Make sure you've tested your grader changes before applying them to student submissions.
+</Warning>
+
 ## Quickstart: Java and Python
 
 Build system integration guides for common programming languages.

staff/assignments/extensions-and-scoring.mdx

@@ -0,0 +1,80 @@
+---
+title: "Extensions and Score Capping"
+description: "Manage due date extensions and configure assignment score limits"
+---
+
+# Extensions and Score Capping
+
+Pawtograder provides flexible options for managing due date extensions and controlling assignment scores.
+
+## Extended Due Date Picker
+
+When granting manual extensions to students, instructors can choose the extended due date directly using a date picker interface.
+
+### Benefits
+
+The date picker approach offers several advantages over entering hours and minutes:
+
+- **Intuitive selection**: Pick a specific date and time visually
+- **Reduced errors**: Avoid calculation mistakes when determining extension length
+- **Course alignment**: Easily set extensions that align with course schedules or other deadlines
+- **Clear communication**: The exact due date is immediately visible
+
+### How to Grant Extensions
+
+1. Navigate to the assignment's "Due Date Exceptions" section
+2. Select the student(s) who need an extension
+3. Click "Grant Extension"
+4. Use the date picker to select the new due date and time
+5. The system displays both the original and extended due dates for reference
+
+The date picker shows the original due date and allows you to select any future date and time for the extended deadline.
+
+<Tip>
+You can grant extensions to individual students or to entire groups for group assignments. All group members will receive the same extended deadline.
+</Tip>
+
+## Assignment Score Capping
+
+Instructors can configure a maximum score cap for assignments to prevent scores from exceeding a specified limit.
+
+### When to Use Score Capping
+
+Score capping is useful in several scenarios:
+
+- **Extra credit management**: Prevent bonus points from inflating grades beyond course standards
+- **Grading consistency**: Ensure all assignments follow the same maximum score scale
+- **Optional components**: Allow students to attempt bonus work without breaking grade calculations
+- **Rubric flexibility**: Use detailed rubrics with many points while maintaining a standard maximum
+
+### Configuring Score Caps
+
+To set a score cap for an assignment:
+
+1. Navigate to the assignment settings
+2. Find the "Score Capping" section
+3. Enable score capping
+4. Enter the maximum allowed score
+5. Save your changes
+
+### How Score Capping Works
+
+When score capping is enabled:
+
+- Student scores are automatically capped at the specified maximum
+- The cap applies to the total score (autograder + handgrading combined)
+- Students can see their uncapped score and the capped score that counts toward their grade
+- The gradebook displays the capped score
+
+<Note>
+Score capping is applied after all grading is complete. Students will still see their full earned score, but the capped score is what appears in the gradebook and grade exports.
+</Note>
+
+### Example
+
+If you set a score cap of 100 points:
+- A student who earns 95 points receives 95 points
+- A student who earns 110 points (including bonus) receives 100 points
+- Both students see their actual earned scores, but the gradebook shows the capped values
+
+This allows you to reward excellent work with bonus points while maintaining grade consistency across your course.

staff/assignments/grading-dashboard.mdx

@@ -0,0 +1,52 @@
+---
+title: "Grading Status Dashboard"
+description: "Monitor grading progress and track completion across all assignments"
+---
+
+# Grading Status Dashboard
+
+The grading status dashboard provides a comprehensive view of grading progress across all assignments in your course. Use this dashboard to track which submissions have been graded, identify bottlenecks, and ensure timely feedback to students.
+
+## Accessing the Dashboard
+
+Navigate to the Assignments section and select "Grading Status" to view the dashboard.
+
+## Dashboard Features
+
+### Assignment Overview
+
+The dashboard displays all assignments with key metrics:
+
+- **Total submissions**: Number of student submissions received
+- **Graded submissions**: Count of completed grading reviews
+- **Pending submissions**: Submissions awaiting grading
+- **Completion percentage**: Visual progress indicator
+
+### Grading Progress Tracking
+
+For each assignment, you can see:
+
+- **Grader assignments**: Which staff members are assigned to grade
+- **Due dates**: Grading task deadlines
+- **Status indicators**: Visual cues for on-track, at-risk, or overdue grading
+
+### Filtering and Sorting
+
+Use filters to focus on specific assignments:
+
+- Filter by assignment status (active, past due, upcoming)
+- Sort by grading completion percentage
+- View only assignments with pending grading tasks
+
+## Taking Action
+
+From the dashboard, you can:
+
+1. **Navigate to assignments**: Click any assignment to view detailed grading interface
+2. **Reassign grading tasks**: Adjust grader assignments if needed
+3. **Monitor progress**: Track grading completion in real-time
+4. **Identify delays**: Quickly spot assignments that need attention
+
+<Tip>
+Use the grading status dashboard regularly to ensure students receive timely feedback and to balance grading workload across your staff.
+</Tip>

staff/assignments/security-dashboard.mdx

@@ -0,0 +1,72 @@
+---
+title: "Assignment Security Dashboard"
+description: "Monitor and audit assignment security, detect potential academic integrity issues"
+---
+
+# Assignment Security Dashboard
+
+The assignment security dashboard helps you monitor assignment security and identify potential academic integrity concerns. Use this tool to audit submission patterns and detect anomalies that may warrant further investigation.
+
+## Accessing the Security Dashboard
+
+Navigate to an assignment and select the "Security" tab to view the security dashboard.
+
+## Dashboard Features
+
+### Submission Pattern Analysis
+
+The dashboard analyzes submission patterns across all students to identify:
+
+- **Unusual submission timing**: Submissions that occur at unexpected times
+- **Similarity patterns**: Groups of submissions with similar characteristics
+- **Anomalous behavior**: Deviations from typical student submission patterns
+
+### Security Metrics
+
+Key metrics displayed include:
+
+- **Submission timestamps**: When students submitted their work
+- **Repository activity**: Commit patterns and timing
+- **File change patterns**: Unusual modifications or additions
+- **Access logs**: Repository access history
+
+### Flagged Submissions
+
+The dashboard automatically flags submissions that may warrant review:
+
+- Submissions with unusual patterns
+- Multiple submissions from different accounts with similar content
+- Suspicious timing or access patterns
+
+## Investigation Tools
+
+When reviewing flagged submissions, you can:
+
+1. **View detailed logs**: Access complete submission and repository history
+2. **Compare submissions**: Side-by-side comparison of flagged submissions
+3. **Review commit history**: Examine the development timeline
+4. **Export data**: Generate reports for academic integrity proceedings
+
+## Best Practices
+
+<Warning>
+The security dashboard is a tool to assist in identifying potential issues, not a definitive proof of academic misconduct. Always investigate flagged items thoroughly and follow your institution's academic integrity policies.
+</Warning>
+
+- Review flagged submissions promptly
+- Consider context when evaluating patterns
+- Document your findings for potential follow-up
+- Combine dashboard insights with other evidence
+- Follow institutional policies for academic integrity cases
+
+## Privacy and Compliance
+
+The security dashboard:
+- Only displays data to authorized course staff
+- Maintains audit logs of dashboard access
+- Complies with student privacy regulations
+- Stores data securely according to institutional policies
+
+<Tip>
+Use the security dashboard proactively throughout the assignment period, not just after the deadline. Early detection can help you address issues before they escalate.
+</Tip>