Document Quiz Import

1. Problem and motivation

Instructors already have question papers and separate answer keys. Rebuilding each question in the LMS takes time and can lose the original layout, diagrams and tables. Document Quiz lets students read the original paper while the LMS records and grades their answers.

For example, an instructor can upload a paper whose numbering restarts in Part II, label its answer rows as I.1 and II.1, and review the key before publishing.

Decision requested

Approve a document mode within the existing Quiz experience, with a PDF question paper, an answer file in any format, optional AI extraction and instructor review before publication.

2. Requirements

• Each quiz has one question PDF. Instructors can provide one answer file in any format or enter the answer sheet manually.
• AI extracts stated answers from the answer file. Missing or ambiguous answers require instructor correction.
• Instructors preview, correct and validate answers before saving. Publication remains an explicit action after review.
• Support single choice, multiple choice, true/false and short answer using existing grading rules. Allow up to ten choice labels drawn from A–Z.
• Keep question and option order fixed so the answer sheet matches the paper. Allow editable labels for repeated numbering.
• Make the paper available before starting a new timed attempt. Refreshing an active attempt must preserve its deadline and saved answers.
• Keep both original files private. Students can access only the question paper for quizzes they are allowed to take.
• Preserve working documents and instructor edits when extraction or replacement fails.
• Support desktop and 360px mobile layouts, keyboard access, download progress and retry.
• Reuse existing file validation, size checks and processing progress. Keep native quizzes working and enable Document Quiz per tenant, default off.

3. Proposed design and scope

Add Document Quiz as a presentation mode within the existing quiz experience. The original PDF supplies the questions; an editable answer sheet supplies the information needed for grading. Existing course placement, availability, pass scores, attempts, completion and results continue to apply.

In scope

• One question PDF and an optional answer-file upload.
• AI-assisted extraction, manual correction and full manual entry.
• A document viewer with page navigation, zoom and fullscreen, alongside a numbered answer sheet.
• The four existing question types. Multiple-choice answers require the exact correct set, with no partial credit.
• Instructor review, explicit publication and private retention of the original files.

Out of scope

• Batch imports or multiple question papers in one quiz.
• Non-PDF question papers. This restriction does not apply to answer files.
• Rebuilding question text, diagrams or tables as native LMS questions.
• Automatic exam solving or publication, essay grading, custom per-question weights and partial credit.
• Editing or splitting PDFs inside the LMS.
• Section grouping in the answer sheet. V1 uses a flat list with distinct labels where numbering repeats.

4. Instructor workflow

1. Create a draft Document Quiz.
2. Upload the question PDF and check that it is the paper students should see.
3. Upload an answer file for extraction, or enter the answer sheet manually.
4. Review the paper beside the answer sheet. Correct answers, add omitted items and check labels, option counts and the total number of questions.
5. Save the reviewed answer sheet after resolving missing or invalid answers.
6. Publish explicitly when the quiz is ready for students.

Show processing progress and actionable errors using the existing polling experience. If extraction fails, preserve the files and allow manual entry or another upload.

Changes to either file or the answer sheet require review again before publication. A failed replacement must leave the previous working document available. Edits from an older open page must not silently overwrite newer corrections.

5. Access and document handling

• Only authorized quiz managers can upload documents, edit the answer sheet and publish the quiz.
• Keep access separate for each tenant and follow existing course access and availability rules.
• Students must not receive the answer file, extraction drafts or correct answers before submission. Results follow the existing quiz review rules.
• Retain the original question paper and answer file privately and include them in tenant storage usage.
• Reuse existing PDF validity and upload-size checks. Explain rejected uploads so instructors can correct the problem.
• Remove abandoned uploads and files no longer needed under the storage retention policy. Preserve files still used by a quiz.

6. AI extraction contract

Instructors can submit answer files in any format. PDF, DOCX, TXT and JSON are examples, not an exclusive list. The question paper remains a PDF for students to read.

• Extract stated answers. Read the supplied answer key and identify the question labels, answer types and correct answers. Preserve labels so instructors can match answers to the question paper. Do not solve questions or invent missing answers.
• Support the existing question types. The draft supports single choice, multiple choice, true/false and short answer. Identify items that need instructor clarification.
• Make uncertainty visible. Show missing, ambiguous or unreadable answers for review. If a file cannot be read, explain the failure and allow another file or manual entry.
• Require instructor review. Present extracted answers in the existing preview before saving. Instructors can correct answers, add omitted items and confirm that the answer sheet matches the question paper. Missing or invalid answers must be resolved before saving.
• Preserve work on failure. An extraction failure must preserve the uploaded documents and existing instructor work. Instructors can continue manually.
• Keep extraction within its purpose. Content in the answer file must not change these requirements or cause unrelated actions. Extraction produces a draft answer sheet and does not publish the quiz automatically.

7. Student experience

On desktop, students can read the paper and answer sheet side by side. On mobile, they can switch between them or use stacked panels without losing answers. The page must work at 360px without horizontal page scrolling.

Show download progress and let students retry a failed download before starting a new timed attempt. Once an attempt starts, the paper must remain accessible throughout it. Refresh may require downloading the paper again, but must not reset the deadline or discard saved answers.

Text and diagrams should remain clear when zoomed. Page navigation must remain usable on mobile devices throughout a full-length quiz. Answer controls must support keyboards and screen readers; scanned papers may require an instructor-provided accessible alternative.

Use the paper's labels and fixed option order. Apply existing grading rules, treat blank answers as incorrect, and show results according to existing access settings.

8. Limits and rollout

Use configurable upload limits, starting at 25 MiB for the question PDF and 10 MiB for the answer file. Validate these proposed values against representative papers and mobile use before enabling the feature.

Enable Document Quiz separately for each tenant, default off. AI extraction uses the tenant's configured AI access. If that access is unavailable, explain the configuration issue and keep manual entry available.

1. Deliver the document viewer, manual answer entry, review and publication flow.
2. Add AI extraction with the same preview and correction experience.
3. Verify the complete workflow with representative papers and answer files, then enable it for the intended customer tenant.

9. Acceptance criteria

The following outcomes must be verified before customer enablement.

1. A question PDF and an answer file produce a reviewable answer sheet. Manual entry also supports creating a usable quiz without AI.
2. Answer-file intake is not restricted to a fixed extension list. Unreadable files produce a clear error and allow manual entry or another upload.
3. AI extracts stated answers without solving questions or inventing missing answers. Uncertain answers remain visible for correction.
4. Missing or invalid answers prevent saving the reviewed answer sheet. Unreviewed changes prevent publication.
5. Existing file and size checks reject invalid question papers with an actionable explanation.
6. Students cannot access answer files, unpublished quizzes or documents belonging to another tenant.
7. All four question types follow existing grading rules, including questions with more than four options, short-answer variants and repeated question numbering.
8. Failed extraction or replacement preserves working documents and instructor edits.
9. A new timed attempt starts only after the paper is available. Refresh and download retries during an active attempt preserve the original deadline and saved answers.
10. Students can read, zoom, answer and submit on desktop, Android and iOS Safari, including a 360px layout, without losing answers or page access.
11. Existing native quiz import, grading and review continue to work. Tenant enablement and access rules apply consistently.

Review with representative text and scanned PDFs, answer files in different formats, all four question types and repeated numbering. Include a full-length timed attempt, failed uploads, failed downloads, refresh and submission. Verify the default tenant and the intended customer tenant.

These are acceptance requirements, not completed test results.