Collaboration
Contributions and Class Review
See what each member of a project created, changed, commented on and approved; instructors compare each student's work with an assignment's due date and export a class roll-up.
On this page
- How to use it
- See each member's work
- Print or export
- Set an assignment due date (instructors)
- Give instructions and a starter project (instructors)
- Lock group projects at the due time
- Grade with a rubric and export to your gradebook
- Turn AI off for an exam (org admins)
- Compare with a due date
- Review a group project without joining it (instructors)
- Export the class roll-up (instructors)
- Teaching assistants
- Download the solution notes
- Ask AI for a summary
- Who sees what
- How the counts are made
Contributions shows each person's work in a project: the items they created and changed, their relationships, diagrams, comments and approvals, and when they worked. It links to the work itself, so you can read it before you judge it. The counts show activity, not the quality of the work.
Instructors and teaching assistants of a class organization also get Class Review: assignments with due dates, a baseline of every group project at each due date, each student's work, and a roll-up for the gradebook.
How to use it
See each member's work
- Open the project. Press ⌘K / Ctrl+K and choose Contributions, or click Share and then See each member's contributions.
- The table has one row per member, with the member's Role, Items created, Items changed, Relationships, Diagrams, Comments, Approvals, Active days and Last activity. Under each name, the classes they worked on are listed, for example "Requirement 12 · Action 4".
- Click a row. You see the member's work:
- Items by class: created and changed, per class.
- Items created and Items changed, each with a link to the item, its class, the number of changes and the last change.
- Documents the member worked on (a document counts when they created or changed the document or one of its items).
- Relationships, each as source, relationship and target with the items' current names (for example "Filter water → verified by → Log flow").
- Diagrams and whiteboards, Comments and Approvals.
- Item history: the history records under the member's name, with the fields that changed.
- Click ← All members to go back.
Print or export
- Print / PDF on a member's page opens the print dialog. Choose Save as PDF to keep a copy for one student.
- Export (Excel) writes one sheet with every member and one sheet per member with their counts by class.
- Export (CSV) writes the members table.
Set an assignment due date (instructors)
- Open Organization Settings → Class Review, or press ⌘K / Ctrl+K and choose Class Review.
- Under Assignments, click + New Assignment. Enter a name, such as "Concept Review", the due date and the time in your time zone. Click Add Assignment.
- At that moment the server takes a baseline of every project of the organization: each member's counts and a version of the project. The status changes from Scheduled to Baselines taken.
Change… renames an assignment, or moves its due date while it has not passed. Remove deletes the assignment and its comparison; the versions kept at the due date stay in each project's history.
Give instructions and a starter project (instructors)
In the New Assignment (or Change…) dialog:
- Instructions: what the groups do, what to hand in and how it is graded. Students see them in their group projects: the banner under the top bar names the next assignment with Instructions, and their project's Contributions page lists every assignment under Assignments.
- Starter project: a project you own, for example a copy of the EO-1 model or the LISM Class Starter. Click Add Assignment (or Save).
Then click Hand Out on the assignment's row and confirm. Holarch copies the starter once into a new project for each group, named "group project · assignment". Each copy:
- belongs to the class organization and does not count toward the students' active projects;
- is owned by the group project's owner, with the group's members in the same roles; instructors and teaching assistants get Reviewer access as on every class project;
- is never shared with your starter: the groups do not see your project, and later changes to it do not reach the copies.
Hand Out again copies only for groups that have no copy yet, for example a group formed later. Once handed out, the starter of that assignment cannot change; add a new assignment for another one. A group whose owner has no room for the attached files gets the copy without them, and the summary says so.
An assignment without a starter project works in the groups' own projects.
Lock group projects at the due time
In the assignment dialog, under Due-date lock, tick Make the group projects read-only for students at the due time. From the due time on, students who own or edit a group project of the assignment act as reviewers: they read, export and comment, but cannot change the model, the project's members or its organization. The page shows Read only with the assignment and its due time. Instructors and teaching assistants keep their access.
- Extension for one group: in Grades, click Extension… on the group's row and choose a later date and time. The group keeps working until then; Remove Extension takes it back. An extension after the lock started opens the project again.
- Reopen date: optional. From then on, every group can edit again.
- When the class status ends, the lock ends too and students get their projects back.
The baseline is still taken at the assignment's due time, so Compare with shows the work done during an extension as changes after the due date. Times are stored in UTC and shown in each person's own time zone.
Grade with a rubric and export to your gradebook
Give the assignment a Rubric: click + Add Criterion and enter each criterion's name, points and, optionally, what earns full points. Without criteria, a grade is one number out of Points possible (100 when empty).
- In Class Review → Assignments, click Grades on the assignment's row. You see every group with its students.
- Click Grade… on a group's row, enter the points per criterion and a comment, and click Save. The grade applies to every student of the group.
- To grade one student apart from the group, click Own Grade… on the student's row. A student's own grade replaces the group's in the export; Clear Grade takes it away.
Teaching assistants grade too. Students do not see grades or comments in Holarch: they get them from your gradebook.
Under Export Grades, choose the Gradebook and click Export (CSV). Each file has one row per student:
| Gradebook | Columns | Students are matched by |
|---|---|---|
| Canvas | Student, ID, SIS User ID, SIS Login ID, Section, the assignment (with a Points Possible row) | SIS Login ID, filled with the student's email address |
| Moodle | Email address, Full name, the assignment, its feedback | Email address (choose it under Map from when you import) |
| Blackboard Learn | Last Name, First Name, Username, the assignment with its total points, Feedback to Learner, Feedback Format | Username, filled with the student's email address |
| Holarch (all details) | Group project, student, email, role, each criterion, total, possible, where the grade came from, comments, extension | — |
If your school's Canvas login IDs or Blackboard usernames are not email addresses, export the gradebook from the learning management system first and copy the grade column into it. Each export is recorded in the audit log.
Turn AI off for an exam (org admins)
- In Class Review, under Exam AI Windows, click + New Exam Window.
- Enter a name, such as "Midterm exam", and under Where choose one project or Every project of the class.
- Leave At a set time ticked and choose the start and end (up to 14 days, in your time zone), or untick it to keep AI off until you remove the window. Click Add Window.
While the window runs, AI is off for the students in those projects: Ask AI, every AI tool and AI apps connected through MCP say that AI is turned off for students during an exam. A banner under the top bar names the exam and when it ends. Instructors and teaching assistants keep AI and see the same banner. Remove ends a window at once. Teaching assistants see the windows but do not add or remove them. The organization's AI permissions and its REST API switch stay as they are.
Compare with a due date
- In Contributions (or a group project in Class Review), choose the assignment under Compare with.
- Each count shows its value as of the due date in parentheses where it differs. After due date counts the changes made later.
- On a member's page, work changed later is marked Changed after due date with the date; work added later is marked Added after due date.
Review a group project without joining it (instructors)
In Class Review → Group projects, click a project. You see its members and each member's work, as above. Item names open a preview with the item's text and its comment threads, replies under the comment they answer. Open Item opens the item in its project, where you reply to a comment with Reply; a reply notifies the thread's earlier writers, as comments do.
Export the class roll-up (instructors)
Under Class roll-up, optionally choose an assignment under Compare with, then click Export (Excel) or Export (CSV). The Excel file has one sheet with every student across the groups (with their email address for your gradebook), one sheet per group and one sheet per student. With an assignment, it adds the counts at the due date and the changes after it.
Teaching assistants
An org admin of a class organization gives a member the Teaching assistant role: in Organization Settings → Organizations, open the organization and choose Teaching assistant in the member's role list, or as the Role under Add Members. The role exists only in organizations with class status.
A teaching assistant:
- opens Class Review from the account menu, or with ⌘K / Ctrl+K → Class Review;
- sees each student's work, exports the class roll-up and asks AI for a summary when the class allows AI;
- downloads the solution notes of the instructor package;
- is a Reviewer of every project of the organization: opens it, reads, comments and approves requirements, but does not edit. The project's Share list shows them as Reviewer · TA; owners cannot remove them or lower the role. Projects that join the organization later get the TA too; when a project leaves the organization, or the TA role ends, that access ends.
Org admins of a class organization (instructors) get the same Reviewer access to every project of the organization, shown in Share as Reviewer · Instructor. An instructor or TA who is already an editor or owner of a project keeps that role there.
A teaching assistant does not manage members or invitations, the AI and API switches, organization keys, class status, single sign-on or the audit log, and cannot delete the organization.
Assignments stay with the org admins. To let teaching assistants add, change and remove them, open the organization's Class group and tick Teaching assistants can add, change and remove assignments.
Download the solution notes
The instructor package has six example assignments on the EO-1 reference model, A1 to A6, with rubrics and learning outcomes. The solution notes are not published: in Class Review, under Instructor package, click Download Solution Notes. Each download is recorded in the audit log. Do not hand them out.
Ask AI for a summary
On a member's page, the ✦ AI control (in Class Review, Summarize Work…) writes a few paragraphs about the recorded activity: what parts of the model the person worked on and when. The summary is marked AI-written. It is not a grade and does not judge the quality of the work. It follows the organization's AI setting: when an org admin turns AI off, the summary is not available.
Who sees what
| Person | Sees |
|---|---|
| Project owner | Every member's row and work. |
| Org admin of the project's class organization (instructors) | Every member's row and work, and Class Review, with Reviewer access to the project. |
| Teaching assistant of the project's class organization | The same as an org admin. |
| Other members | Their own row and their own work only. |
| Anyone else | Nothing. |
Viewing another person's work, exporting the class roll-up or grades, grading, handing out starter projects, extensions, exam windows and changing assignments are recorded in the audit log. Class Review needs an organization with class status (see Run a class); give TAs the Teaching assistant role (see Teaching assistants).
How the counts are made
- Every change a page sends is stored with its author's account and the time the server received it. Holarch keeps a per-person index of these changes, so the counts stay after the change log is compacted. Times are the server's receive times: work saved offline counts when it reaches the server. Work from before the index started counts where the item history names a member.
- An item counts as created by the person who created it and as changed for anyone else who changed it later. Items that were deleted are not counted; the number of items a person created that are now deleted shows on their page.
- A change is one action, such as an edit, a new item or a comment, however many fields it touches. Active days are the days with at least one change, in your time zone.