For assistants

Signing in

You authenticate with your personal A+ API token. Hanami exchanges it for an opaque browser session and keeps the encrypted token on the server. You can sign in one of two ways:

• Via A+ (recommended when configured): open Hanami from the course’s menu item in A+ and you are signed in automatically. The first launch shows a one-time A+ consent page; tick “automatically continue next time” to skip it on later launches.
• Token paste: copy the API token from your A+ profile page and paste it into Hanami’s token prompt.

Either way you can only see what your own A+ account can access. The front page lists every configured course where your token has an assistant or teacher role.

Work through your queue

1. Open the course and choose Grading. Your queue contains the students or groups assigned to you.
2. Filter by status or search for a student or assignment. Open an entry to enter the grading workspace.
3. Work through the rubric categories. Select phrases, adjust points when the presets do not fit, and annotate the relevant code or autograder feedback.
4. Open Finalize to review the total and the feedback the student will receive.
5. Leave the assessment as a draft if it needs more work. Choose Mark ready when a teacher can review and send it.

An assignment needs a rubric before it can appear in the queue. Submissions are grouped by student or group.

For each entry you see the submitted code, its A+ submission tags, and the autograder output alongside it. Tags also appear in the student switcher and can be searched by slug, so tags added manually or by an automatic grader can act as a lightweight attention queue.

Annotate and assess

Annotations attach to submitted code lines and can be linked to a rubric category. To create one, select code or use the visible comment action. The current category is selected automatically; you can change or remove the link later.

Each category also has preset phrases with point changes. Selecting phrases updates the category points, but you can override the value when the presets do not fit. Hanami builds the final feedback from the selected phrases and annotations.

Changes autosave as a draft after you edit. The status in the navigation bar shows when a save is pending or has failed. Do not mark the assessment ready until the save has completed.

Draft, ready, sent

Keep unfinished work as a draft and mark it ready when it is done. Only a teacher can send, because the A+ grade API rejects assistants. A teacher reviews ready work and sends it. The points and feedback then appear in A+ as a new graded submission.

Written feedback

Separate from per-exercise grading, you can write feedback documents for a student. Open Feedback, select a student, and create a document. A document can contain headings, comments, and pinned code files with annotations.

Use the email action when the document is ready. You get a copy, replies go to your address, and the document becomes visible in the student’s read-only Hanami view. If email is not configured, sending fails and the document remains private to staff.

Each pinned file shows the tags of its exact A+ submission. This keeps flags attached to the right version when a document contains files from multiple submissions.

Each saved document has its own short URL, and every annotation and comment offers a Copy link action. The copied link points at that exact remark; opening it loads the document, reveals the file it belongs to, and scrolls to the comment, which is handy for referring a colleague or the student to one specific note.