BodhiTree Instructor Manual

A practical guide to running a course on BodhiTree, written for instructors and teaching assistants.

Applies to: BodhiTree Barberry (v25.10.0), production build.

Contents

#	Chapter	Covers
1	Getting Started	Accounts, signing in, Instructor mode, roles and what each can do
2	Creating and Setting Up a Course	Creating, importing, publishing, and the seven settings cards
3	People and Enrollment	All four enrollment methods, CSV format, approvals, TAs
4	Course Content — the Multimedia Book	Chapters, videos, documents, quizzes, in-video quizzes
5	Labs and Activities	Programming activities, testcases, quiz activities, import/export
6	Exams and Proctoring	Exam setup, the live dashboard, flags, approvals, time changes
7	Grades and the Gradebook	How marks are calculated, extra columns, CSV import, publishing
8	Announcements, Email and the Forum	Reaching your class, moderation, the schedule
9	Analytics and Statistics	Reports, leaderboards, exports
10	Reference	Every limit, format, and permission in one place
A	What Your Students See	Each setting mapped to its effect on students

Start here

New to BodhiTree? Read Chapter 1, then Chapter 2, and set up a course before reading further.

Setting up a course for a new term? Chapter 2 → Chapter 3 → Chapter 4. Reuse last term’s material with Import Chapters (§4.6).

Running an exam? Chapter 6 in full, before the day.

Working out grades? §7.1 first — it will probably change how you set up your assessment.

Five things that surprise people

There is no grade weighting. Every mark goes into one flat pool. To make a category count more, give it more marks. (§7.1)
Instructor and STA are identical in power. The role is derived from course ownership, not chosen. Only the creator keeps extra rights. (§1.4)
Unpublished content is invisible, not greyed out. “I can’t find the assignment” almost always means unpublished. (§A.2)
Two devices at a time. A third sign-in silently logs you out everywhere else. (§1.2)
The Recycle Bin only covers Programming activities. Quiz and Virtual activities are deleted permanently. (§5.6)

Conventions in this manual

Bold marks something you click or type.
Italic quotes are messages BodhiTree shows you, word for word.
⚠️ blocks flag destructive actions and behaviour that commonly catches people out.
Every chapter ends with Known limitations — features that are absent, partial, or behave unexpectedly. These are documented deliberately so you do not lose time hunting for something that is not there.

About accuracy

Every claim here was checked against the BodhiTree source code rather than against design documents, because several design documents describe features that were never built. Where a feature is planned but absent, it is listed under Known limitations rather than described as working.

Notably not documented as working, despite appearing in internal design documents: gradebook category weighting, Excel export of grades, exam enforcement for virtual labs, backend deadline blocking on quiz resubmissions, and single sign-on.

If you find the software behaving differently from this manual, the manual is what needs correcting — please report it.

Rebuilding this manual

This manual was generated from the codebase and can be regenerated as BodhiTree changes. See GENERATION.md for the method, and SCREENSHOTS.md for the list of images still to be captured.