Skip to content

Commit

Permalink
copy over to the old 'teachertool' page
Browse files Browse the repository at this point in the history
  • Loading branch information
ganicke committed Jan 16, 2025
1 parent afaf457 commit df3488f
Showing 1 changed file with 13 additions and 7 deletions.
20 changes: 13 additions & 7 deletions docs/teachertool.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Overview

The [Code Evaluation Tool]( https://microbit.makecode.com/beta--eval) is a mechanism for constructing a checklist of requirements for an assignment and running that list automatically against projects in quick succession. This allows teachers to build a checklist, then easily evaluate any number of projects based on that checklist. Projects are evaluated one at a time, but with auto-run enabled, you can update the loaded project by providing a new share link, at which point the rules will automatically be re-run on the new project.
The [Code Evaluation Tool]( https://microbit.makecode.com/--eval) is a mechanism for constructing a checklist of requirements for an assignment and running that list automatically against projects in quick succession. This allows teachers to build a checklist, then easily evaluate any number of projects based on that checklist. Projects are evaluated one at a time, but with auto-run enabled, you can update the loaded project by providing a new share link, at which point the rules will automatically be re-run on the new project.

## Code Evaluation Tool Features

Expand Down Expand Up @@ -59,23 +59,29 @@ Parameter options are displayed and then selected.

![Criteria parameters 3](/static/teachertool/parameters-3.png)

#### 5. Remove Criteria
#### 5. Ask AI

You can also have an **Ask AI** question as a criteria item in the checklist. You are limited to up to 5 Ask AI questions per checklist.

![Ask AI criteria](/static/teachertool/ask-ai-criteria.png)

#### 6. Remove Criteria

A criteria item is removed using the **trash** button.

![Remove Criteria](/static/teachertool/remove-criteria.png)

#### 6. Load a project
#### 7. Load a project

A project into the project view by pasting in a share link or share ID.
Load a project into the project view by pasting in a share link or share ID.

![A loaded project](/static/teachertool/loaded-project.png)

The project will load in read-only mode with the project title appearing at the top of the project view.

![Project validation](/static/teachertool/validate-me.png)

#### 7. Run the checklist
#### 8. Run the checklist

With a project loaded, the checklist can run. The results are shown after clicking the **Run** button.

Expand Down Expand Up @@ -133,13 +139,13 @@ If auto-run is **enabled**, any rules that enter the "Not started" state due to

#### 1. Pre-built checklists

There are pre-built checklists are available from on home page. If a selected checklist is already in-progress, an overwrite confirmation prompt is given.
There are pre-built checklists are available on the welcome page. If a selected checklist is already in-progress, an overwrite confirmation prompt is given.

![Pre-built checklists](/static/teachertool/prebuilt-rubrics.png)

#### 2. Export a checklist

A checklist is exported using the vertical "..." menu near the "auto-run" button.
A checklist is exported using the vertical "..." menu near the "auto-run" button. Only the checklist is exported, not the results. For a copy of the results, use the [print](#other) function in the Results view.

![Export checklist](/static/teachertool/export-checklist.png)

Expand Down

0 comments on commit df3488f

Please sign in to comment.