Use Case: Managing the Homework Cycle
Walkthrough for homework creation, assignment, tracking, grading, and feedback.
Prerequisites
- Active course with enrolled students
- Lessons with exercise content available
- Familiarity with the Lex Editor
Phase 1: Creating Homework Content
Step 1: Choose Your Homework Type
Lesson-Based Homework: Assign an existing lesson from your course. Students complete the lesson and its exercises independently. Best for structured practice tied to recent class content.
Custom Homework: Create a standalone assignment using the Lex Editor. You have full control over content, exercises, and instructions. Best for targeted practice or assessments.
Community Pool Homework: Create homework tasks that can be checked by other teachers in the community pool. Best for scaling grading across your organization.
See Community Homework Pool for details on pool-based assignments.
Step 2: Create Homework Content
Open the Homework Section
Navigate to your course, then click "Homework" in the sidebar. Click "Create Homework".
Select Content Type
Choose between:
- Existing Lesson -- pick a lesson from your course library
- New Content -- opens the Lex Editor for custom content
Build or Select Content
If creating new content, use the Lex Editor to add:
- Instructions and context
- Exercises (multiple choice, fill-in-the-blank, matching, sentence builder)
- Reading passages or vocabulary lists
- Audio or media for listening tasks
If using an existing lesson, select it from the dropdown and optionally customize which sections are included.
Set Homework Parameters
- Title: Clear, descriptive name (e.g., "Unit 3: Past Tense Practice")
- Instructions: What students should do, how long it should take, what to focus on
- Due Date: When the assignment is due
- Estimated Time: How long it should take (helps students plan)
Save
Click "Save Homework" to store the assignment. It is not yet assigned to anyone.
Phase 2: Assigning Homework
Step 3: Assign to Students
Open Assignment Panel
From the homework detail page, click "Assign".
Select Recipients
Choose who receives this homework:
- Individual students -- select specific students from your enrollment list
- Student group -- assign to an entire group at once (see Student Groups)
- All enrolled students -- everyone in the course
Set Due Date and Notifications
- Confirm or adjust the due date for this assignment batch. Look for the next-class suggestion pills — clickable time slots that auto-fill the date/time from the student's schedule, saving you from typing manually.
- Enable email notifications so students are alerted immediately
- Optionally add a personal message
Confirm Assignment
Click "Assign Homework". Each selected student receives a HomeworkRequest with status "assigned".
Phase 3: Tracking Progress
Step 4: Monitor Submissions
Homework Dashboard View:
Navigate to "Homework" -> "Active Assignments" to see:
| Student | Status | Submitted | Score | Action |
|---|---|---|---|---|
| Maria Garcia | Submitted | Mar 10 | -- | Grade |
| John Smith | In Progress | -- | -- | Remind |
| Anna Kowalski | Not Started | -- | -- | Remind |
| Li Wei | Graded | Mar 9 | 85% | Review |
Status Flow:
assigned -> in_progress -> submitted -> graded
-> returned (needs revision)Step 5: Send Reminders
For students who have not started or are falling behind:
- Select unsubmitted students from the dashboard
- Click "Send Reminder"
- The system sends an automated reminder with the due date
- Optionally add a personal note
Set up automatic reminders 24 hours before the due date in your course settings. This saves you from manually chasing students.
Phase 4: Grading
Step 6: Review and Grade Submissions
Open a Submission
Click "Grade" next to a submitted assignment. The student's work opens with their answers visible alongside the correct answers.
Review Auto-Graded Exercises
Exercises like multiple choice and fill-in-the-blank are auto-graded by the system. Review the automatic scores and adjust if needed (for example, accepting alternative correct answers).
Grade Open-Ended Responses
For exercises requiring manual review:
- Read the student's response
- Compare against your rubric or expectations
- Assign a score (percentage or points)
- Mark specific areas that need attention
Add Written Feedback
Provide constructive feedback in the comment field.
Set Final Score
The system calculates an aggregate score from all exercises. You can override this with a manual final score if needed.
Submit Grade
Click "Submit Grade". The HomeworkRequest status changes to "graded" and the student is notified.
Step 7: Handle Revisions
If a submission needs more work:
- Click "Return for Revision" instead of submitting a final grade
- Add detailed comments explaining what needs to be fixed
- Set a new due date for the revision
- The student receives the homework back with status "returned"
- They revise and resubmit
Phase 5: After Grading
Step 8: Analyze Results
After grading all submissions, review:
- Average score across the class
- Common mistakes or weak areas
- Score distribution (who struggled, who excelled)
- Completion rate
Use this data to plan review sessions for common errors and adjust future homework difficulty.
Next Steps
- Homework Management - Detailed reference for all homework features
- Community Homework Pool - Scale grading with community help
- Conducting Live Sessions - Review homework in live class



