Ground-Truth

Instructor Guide

Turn your course material into grounded questions, review what the model wrote, build an exam, and grade attempts with a reason for every mark.

Sign inCourseMaterial Question BankQuestion Modeler ExamGrade
The idea: every question is written from your material and must quote it. Nothing is invented from the model's general knowledge — if a claim isn't supported by what you uploaded, the question is dropped before you ever see it. Grading works the same way: each mark comes with a reason and the source line it relied on, and you can override any score.
1

Sign in

instructors only — students never sign in
Ground-Truth
Academic instructors — sign in or request access.
Email address
you@university.edu
Access code
AB12-CD34
Sign in
Don't have a code? Request access →
  1. Sign in with the email you registered and your access code.
  2. No code yet? Request access with an institutional (.edu) address and one is issued to you.
  3. Signing in is what makes your work persist. You can use the whole app without an account first — see the Guest guide — and your trial work is carried over when you sign in.
2

Create or import a course

start blank, or bring one over from Brightspace
Ground-Truth · your courses
+
New course
Start with two blank modules
⤓
Import from Brightspace
Common Cartridge (.imscc)
  1. New course gives you two empty modules to fill.
  2. Import takes a .imscc export from Brightspace. You choose which content becomes a module — you are not forced to take the whole cartridge.
  3. Brightspace quizzes are opt-in: they appear as unticked entries in the import picker, so an import never silently fills your bank with someone else's questions.
  4. Deleting a course removes everything under it — modules, questions, material, exams and student attempts.
3

Add your material

this is the only thing questions can be built from
📁 Your material
⬆️
Upload files
Drag & drop or browse
PDFPPTXDOCX Notes / txtAudio / Video
AND / OR
https://youtu.be/… , https://example.edu/notes
Submit
  1. Open a module from Course Content on the left, then add files or paste links.
  2. Audio and video are transcribed, so a recorded lecture works as material.
  3. Submitting builds the module's knowledge base and immediately starts generating questions — you can leave the page and come back.
  4. Adding or deleting material rebuilds the knowledge base and clears that module's bank, because the old questions were grounded in the old text.
4

What generates automatically

nine passes across the whole document
📁 Question Bank 87 questions 📊 covers 78% of material
Easy Medium Hard × Multiple choiceShort answerOral
Each combination reads a different section of your material.
  1. Three question types across three difficulties — nine passes, each assigned its own slice of the document so the bank isn't all drawn from your opening pages.
  2. Difficulty maps to Bloom's levels: "Hard" demands harder thinking, not trickier wording.
  3. The coverage badge tells you how much of your material the bank actually draws on. A low number means whole sections are untested.
  4. If the model service is unreachable, the module says so and offers Retry. It will never report "ready" with an empty bank.
5

Question Modeler

every other question type, on demand
  1. Each type has its own page with its own options. Pick a module, set difficulty, generate.
  2. Case Study writes a scenario first, then questions that can't be answered without reading it. The scenario travels with the question onto an exam.
  3. Viva produces spoken questions — students answer aloud and the recording is transcribed and graded.
  4. Clone learns from questions you already like and writes new ones in that style, from your material.
  5. You get a preview first. Tick the ones worth keeping and save them into the module's bank — nothing is filed without your say-so.
6

Review in the Question Bank

the model writes a draft; you decide what counts
🗂 Question Bank — every module
Hard Which transport choice suits a real-time game? ⚠ KEY DISPUTED view full reject
Medium In the scenario, what should the team do? 📋 DILEMMA ≈ DUPLICATE
  1. ⚠ KEY DISPUTED — a second model answered the question without seeing the key and disagreed. Grading still uses your stored key, so look before you use it.
  2. ≈ DUPLICATE — very close to another question already in the bank.
  3. 📋 DILEMMA / ANALYSIS / DIRECTED — belongs to a case study.
  4. view full opens the whole question: all options with the correct answer marked, the reference answer, and any scenario — with Accept and Reject in the same window.
7

Rejecting teaches the generator

the part that compounds
A rejected question is kept, not deleted — struck through, barred from exams and exports, and reversible with undo. What matters is the reason you give.
Reason chipsToo easy · Too generic · Not grounded · Reads fake · Too long · Too short. Each becomes a standing instruction that steers every future generation, and they accumulate.
The question textOnly your two most recent rejections are shown to the model as examples to avoid. Text fades; reasons don't.
SoRejecting without a reason teaches almost nothing. One chip is worth more than ten silent rejections.
ScopeDirectives apply to your account across all courses, and shape style only — content is still forced to come from your material.
8

Build, deploy, and share an exam

students need no account
➕ Create Exam ⤴ Export to LMS (Brightspace)
Midterm — Networks 12 Q ● deployed
Student link https://…/student?exam=… Copy
  1. Tick questions anywhere in the bank, then Create Exam. It appears under Exam on the left.
  2. Deploy makes it live and gives you a student link. Students open it, enter a name, and answer by typing or speaking — no sign-in.
  3. An exam copies every question it uses, answer key included. Deleting the module it came from will not affect a live exam.
  4. Export to LMS builds a Brightspace question library instead, if you'd rather run the assessment there.
9

Grade, and correct the grader

every mark carries its evidence
📊 Attempts 3
Jordan Lee — Midterm 7 / 10 Grade
Q1. Explain what IPsec ESP provides. 4 / 5
Why: covers confidentiality and integrity; omits anti-replay.
source: "ESP provides datagram confidentiality via encryption…"
Final score: 4.5Save
  1. Attempts land under their exam. Multiple choice is marked against the key; written and spoken answers are graded against your material.
  2. Grading runs at temperature 0 — re-grading the same answer gives the same score.
  3. Each mark shows why, plus the source line it relied on. Evidence that can't be found in your material is flagged rather than trusted.
  4. Final score is yours. Whatever you type replaces the AI's mark and is what the student sees. The AI grade is a draft.
10

Good to know

Deleting a moduleRemoves its material and its whole question bank. Exams are unaffected — they hold their own copy of every question. The warning tells you the exact count first.
Deleting a courseRemoves everything beneath it, including student attempts. There is no undo.
MarksEasy 1, Medium 2, Hard 3 by default. Edit any question's marks before building the exam; totals are weighted accordingly.
If generation stopsThe module shows the reason and a Retry button. Usually the model service is down or a model id in the server's settings is wrong — your material is never at risk.
QuantitativeOnly produces questions when your material contains worked formulas. It deliberately refuses to invent numbers from prose.
Every AI grade is a draft with evidence — you confirm or override it. Questions and grading are grounded in your material first.