Help
Plain-English reference. Keep this short and skim-friendly.
Adding a single question
From the dashboard click New question. Type the stem in the big box (it uses a serif font, like a textbook). Add at least two options on the right; click the circle to mark the correct answer. Pick a category and difficulty, then click Save. You can attach images after the first save.
Importing many questions at once
Open Import. Pick a DOCX, XLSX, CSV, TXT, or JSON file. Optionally set a default contributor, category, and difficulty so you don't have to set them per question. Click Parse file — the app shows a summary of how many it understood. Click Send to staging and you'll be sent to a review screen where you can Accept or Reject each question, mark some as duplicates of existing ones, and apply bulk defaults. When you're happy, click Commit batch. Bad imports are isolated in staging until you commit, so the bank cannot be corrupted.
Spotting duplicates
Open Duplicates. Each row pairs two questions with a similarity score. Click Compare side-by-side to see the full questions next to each other. Use Keep #N, delete #M to keep one and drop the other, or Mark not duplicates if they're genuinely different. Confirmed not-duplicate pairs are remembered, so they won't show up again.
Building an exam
Click New exam. Pick:
- Manual — you'll add questions one at a time in the next screen.
- Auto — give a blueprint (category mix %, difficulty mix %, total questions, optional "skip questions used in last N years"). The app fills the exam.
- Hybrid — auto-fill, then swap any question you don't like.
On the exam page, use Reject & replace on a question card to swap in a fresh one from the same bucket. When the paper is right, click Finalize — the questions are snapshotted so future edits to the question bank don't change this paper. Then download as PDF (paper / answer key / anonymized / shuffled) or DOCX / XLSX / CSV.
Backups & safety
The system pushes a snapshot to GitHub every night at 02:00 Amman time. From the Backup page you can also download a manual snapshot at any time. To restore, upload a JSON snapshot, click Preview, then type RESTORE in the confirmation field — this replaces all data, so always export a fresh manual backup first.
Audit log
Every change made through the app is logged with the user's email, the action, and the affected record. Visit Audit to see a paged list with optional filters by entity (e.g. questions) or actor (an email).
Keyboard shortcuts
- g q — go to Questions
- g e — go to Exams
- g i — go to Import
- g d — go to Duplicates
- g h — go to Dashboard
- ? — open this page
Need help?
Email Rami at rami@trilot.com.