Abdulmuizz HamzatandRotimi Best
b599f1a017
* Update documentation for ClassroomIO: change Fumadocs to Blume, revise MDX format conventions, and clarify sidebar navigation requirements. * docs: update README and scripts for improved preview and error handling * docs: update Discord link in configuration and documentation * docs: add token-auth route and update documentation formatting * Fix formatting in auto-comment-issues.yml * Fix JSON syntax by adding a comma * fix(docs): declare Blume's Astro build deps so Cloudflare build resolves them blume build generates an Astro project under apps/docs/.blume/ that imports astro, @astrojs/mdx, @tailwindcss/vite, tailwindcss, @tailwindcss/typography, @shikijs/twoslash and @scalar/astro. Under pnpm's isolated node_modules these are nested inside blume and not resolvable from the docs app, so a clean --frozen-lockfile build (Cloudflare) fails at 'Cannot find module astro/config'. Declare them directly in @cio/docs, pinned to blume's resolved versions. * refactor(docs): update API reference paths and documentation for clarity * fix: change platofrm url to docs home page * Refactor documentation for self-hosting ClassroomIO - Removed the Supabase Cloud setup guide as it is no longer needed. - Updated the Enterprise SSO documentation to include a reference link for SSO & licensing. - Added new documentation for Content Security Policy (CSP) configuration. - Created a new section for configuring SMTP for email notifications. - Introduced a comprehensive configuration index for self-hosted ClassroomIO, detailing environment variables and their usage. - Added documentation for optional integrations including Google OAuth, OpenAI, and Unsplash. - Documented the generation and usage of required secrets for ClassroomIO. - Created a section for SSO & licensing, detailing the requirements for Enterprise features. - Added object storage configuration documentation, covering both bundled MinIO and external S3-compatible services. - Documented versioning and upgrade processes for ClassroomIO. - Updated the Coolify and Docker self-hosting guides to streamline configuration references and upgrade instructions. - Enhanced the Railway self-hosting guide with links to relevant configuration sections. - Updated token authentication documentation to reference SSO & licensing. * Add comprehensive guides for ClassroomIO features and functionalities - Introduced a new guide for the Student Dashboard, detailing navigation and features available to students. - Added a guide on using Tags for organizing and filtering courses within ClassroomIO. - Created a guide on how to take attendance in courses, including marking attendance and related functionalities. - Developed a Terminology guide to clarify key terms used throughout ClassroomIO. - Implemented a Token Auth guide for signing users into ClassroomIO from external applications using JWT. - Added instructions for using math in the editor with LaTeX support. - Created a guide for customizing the welcome email sent to students upon enrollment in courses. - Added a guide explaining what ClassroomIO is and its key features. - Updated the home documentation to provide a clearer overview of ClassroomIO and its resources. - Enhanced self-hosted configuration documentation with a new guide for deploying ClassroomIO on Dokploy. - Updated links in the self-hosted configuration documentation for better navigation. - Added new images to support the Dokploy deployment guide. - Updated asset packaging script to handle redirects for the new guide structure. - Fixed footer link to point to the correct Getting Started guide. * chore: uprage version * feat(docs): add DigitalOcean deployment guide and flatten guides structure - Add a guide for deploying ClassroomIO on DigitalOcean using Docker Compose and Caddy for automatic HTTPS. - List DigitalOcean as a deployment option in the self-hosting index. - Move guides out of content/docs/guides into content/docs (student-dashboard, tags, terminology, token-auth, what-is-classroomio, audience, cohorts, community, course, enterprise-sso, mcp, organization, quickstart/*). - Rename home.mdx to index.mdx. - Update package-assets script to emit redirects for the old guides paths. --------- Co-authored-by: Rotimi Best <[email protected]>
69 lines
2.5 KiB
Plaintext
69 lines
2.5 KiB
Plaintext
---
|
|
title: How to Grade an Exercise
|
|
description: Review student submissions, move them through the grading workflow, score answers, and leave feedback.
|
|
---
|
|
|
|
When students submit exercises, their work appears in the **Submissions** tab of the course dashboard. Exercises move through a three-stage workflow: **Submitted → In Progress → Graded**.
|
|
|
|
## Grading workflow
|
|
|
|
| Stage | Meaning |
|
|
| --- | --- |
|
|
| **Submitted** | Student has submitted; not yet reviewed |
|
|
| **In Progress** | You have opened the submission for review |
|
|
| **Graded** | Review is complete and the grade is recorded |
|
|
|
|
Submissions are displayed as cards on a board. Drag a card between columns or open it to change its status manually.
|
|
|
|
:::info[Auto-graded exercises]
|
|
Exercises that use only objective question types (multiple choice, etc.) are auto-graded when submitted. They move directly to **Graded** without manual review. Exercises with open-ended or video questions require manual review and are flagged **Manual grading required**.
|
|
:::
|
|
|
|
## Grade a submission
|
|
|
|
<Steps>
|
|
<Step>
|
|
### Open the Submissions tab
|
|
|
|
From the course dashboard, click **Submissions** in the top navigation.
|
|
</Step>
|
|
|
|
<Step>
|
|
### Open a submission
|
|
|
|
Click any card in the **Submitted** column. The grading modal opens showing the student's answers, a score breakdown, and a comment field.
|
|
</Step>
|
|
|
|
<Step>
|
|
### Review and score
|
|
|
|
Each question shows the student's answer alongside the expected answer or rubric. Scores are calculated automatically where possible. Adjust individual question scores if needed.
|
|
</Step>
|
|
|
|
<Step>
|
|
### Leave a comment (optional)
|
|
|
|
Type feedback in **Add comment**. The student can see this after grading is complete.
|
|
</Step>
|
|
|
|
<Step>
|
|
### Submit the grade
|
|
|
|
Click **Submit Grades**. The card moves to **Graded** and the student's score is recorded.
|
|
</Step>
|
|
</Steps>
|
|
|
|
## Grade with AI
|
|
|
|
Click **Grade with AI** inside the grading modal to get an AI-suggested score and rationale for open-ended answers. Review the suggestion and click **Accept** to apply it or **Reject** to discard it and grade manually.
|
|
|
|
:::warning[Review AI grades before submitting]
|
|
AI grading is a suggestion. Always review the reasoning before accepting, especially for nuanced or context-dependent answers.
|
|
:::
|
|
|
|
## Related guides
|
|
|
|
- [How to Create an Exercise](/guides/create-exercise) — create and configure exercises
|
|
- [How to Create Certificates](/guides/certificates) — certificates that depend on exercise scores
|
|
- [Course](/course) — course overview including the Submissions tab
|