Update EDUCATOR_GUIDE.md
This commit is contained in:
Родитель
5368e1e38f
Коммит
33787108e9
|
@ -1,6 +1,16 @@
|
|||
## Educator Guide
|
||||
# Educator Guide
|
||||
|
||||
### This guide is designed for educators who use [Moodle LMS](https://moodle.org/).
|
||||
This guide is designed for educators who use [Moodle LMS](https://moodle.org/).
|
||||
|
||||
## Table of content
|
||||
1. [How to create an assessment on Moodle using the Assessment App](#create-assessment)
|
||||
2. [How to set up an assessment in the Assessment App](#assessment-setup)
|
||||
3. [How to create a new question bank](#create-question-bank)
|
||||
4. [How to create a new question](#create-question)
|
||||
5. [How to import and export question banks](#import-export-question-banks)
|
||||
6. [How to browse Assessment Analytics](#assessment-analytics)
|
||||
|
||||
## How to create an assessment on Moodle using the Assessment App <a name="create-assessment"/>
|
||||
|
||||
To begin, you need to login to Moodle LMS and follow the steps:
|
||||
|
||||
|
@ -32,68 +42,117 @@ To begin, you need to login to Moodle LMS and follow the steps:
|
|||
|
||||
![createdassessment](../images/createdassessment.jpg)
|
||||
|
||||
8. Now you can type an optional Description, select the deadline and the assessment duration.
|
||||
The assessment was created. You will be redirected to the Assessment App, where you can configure the created assessment: choose the deadline, assessment duration, questions and participants.
|
||||
|
||||
## How to set up an assessment in the Assessment App <a name="assessment-setup"/>
|
||||
|
||||
1. You are on the assessment setup page. Here you can add the assessment description, select the deadline and the assessment duration.
|
||||
|
||||
![assessmentdescription](../images/assessmentdescription.jpg)
|
||||
|
||||
At this stage, you can choose questions from question banks.
|
||||
When you are ready, click **Choose questions**.
|
||||
|
||||
### If you are using the Assessment App for the first time:
|
||||
2. Choose questions from your question banks. You can select the whole question bank or some of the questions from it.
|
||||
|
||||
* Click on **Assessment App**.
|
||||
![choosequestionfromquestionbank](../images/choosefromquesbank.jpg)
|
||||
|
||||
If you do not have any question banks yet, follow the links to [create the first question bank](#create-question-bank) and [add questions](#create-question) in it.
|
||||
|
||||
3. Choose **Participants**. Here you can see the list of participants, which was loaded from the Moodle course.
|
||||
|
||||
![chooseparticipants](../images/chooseparticipants.jpg)
|
||||
|
||||
4. Click **Save changes**. Now the assessment is available for students. They can access it via the course page on Moodle.
|
||||
|
||||
![savechanges](../images/savechanges.jpg)
|
||||
|
||||
## How to create a new question bank <a name="create-question-bank"/>
|
||||
|
||||
1. Click on **Assessment App** on the top of the page.
|
||||
|
||||
![assessmentappfirst](../images/Assessmentappfirst.jpg)
|
||||
|
||||
* Choose **New Question Bank**.
|
||||
2. Choose **New Question Bank**.
|
||||
|
||||
![questionbank](../images/questionbank.jpg)
|
||||
|
||||
* Now you can add a name of the new question bank and add optional description. Click **Create** when you are ready.
|
||||
3. Now you can add the question bank's name and optional description. Click **Create** when you are ready.
|
||||
|
||||
![createquestionbank](../images/createquestionbank.jpg)
|
||||
|
||||
Great job! Now you have an empty question bank. To add questions, follow steps:
|
||||
Great job! Now you have an empty question bank. You can [add questions](#create-question) in it.
|
||||
|
||||
* Click **New Question**.
|
||||
## How to create a new question <a name="create-question"/>
|
||||
|
||||
1. Select the question bank where you would like to add a new question. Click **New Question**.
|
||||
|
||||
![newquestion](../images/newquestion.jpg)
|
||||
|
||||
* Now you are on the page where you can add information about the question: **Name, Description, Options and select the right answer**. Fill the information and click **Create** when you are ready.
|
||||
2. You are on the page where you can add information about the question: **Name, Description, Options and select the right answer**. Fill the information and click **Create** when you are ready.
|
||||
|
||||
![createnewques](../images/createnewques.jpg)
|
||||
|
||||
You should see the question you created. Add more questions if needed.
|
||||
3. You should see the question you created. Add more questions if needed.
|
||||
|
||||
![questionbankques](../images/questionbankques.jpg)
|
||||
|
||||
Now, when you have prepared questions, you can proceed with the assessment set up.
|
||||
## How to import and export question banks <a name="import-export-question-banks"/>
|
||||
|
||||
* Go to the main page and select the assessment.
|
||||
Using the Assessment App, you can easily download and upload question banks.
|
||||
|
||||
![assessmentques](../images/assessmentques.jpg)
|
||||
**How to download a question bank:**
|
||||
|
||||
* Choose questions from the question banks.
|
||||
1. Select a question bank which you would like to export, and click **Download** on the top of the page.
|
||||
|
||||
![choosequestionfromquestionbank](../images/choosefromquesbank.jpg)
|
||||
![selectquestionbanktodownload](../images/selectqbtodownload.png)
|
||||
|
||||
* Choose **Participants**.
|
||||
2. Choose the location on your computer where you would like to save it.
|
||||
3. The selected question bank will be downloaded on your computer in JSON format.
|
||||
|
||||
![chooseparticipants](../images/chooseparticipants.jpg)
|
||||
Here is an example of how the downloaded question bank might look like:
|
||||
|
||||
* Click **Save changes**.
|
||||
```
|
||||
[{
|
||||
"name":"Introduction to Machine Learning",
|
||||
"description":"Machine Learning for Beginners (Microsoft)",
|
||||
"questions":[
|
||||
{"name":"Applications of machine learning",
|
||||
"description":"Applications of machine learning are all around us",
|
||||
"options":["True","False"],"answer":0},
|
||||
{"name":"Machine learning algorithms",
|
||||
"description":"Machine learning algorithms are meant to simulate",
|
||||
"options":["intelligent machines","the human brain","orangutans"],
|
||||
"answer":1},
|
||||
{"name":"Example of a classical ML technique?",
|
||||
"description":"What is an example of a classical ML technique?",
|
||||
"options":["natural language processing","deep learning","neural networks"],
|
||||
"answer":0},
|
||||
"assessmentType":"Quiz"
|
||||
}]
|
||||
```
|
||||
|
||||
![savechanges](../images/savechanges.jpg)
|
||||
**How to upload a question bank:**
|
||||
|
||||
### If you already have questions:
|
||||
Click **Upload** on the top of the Home page. You will see a dialog window where you can choose the question bank from your computer (the file should be in JSON format), and click **Upload**.
|
||||
|
||||
* Choose questions from the question banks.
|
||||
![selectqbtoupload](../images/selectqbtoupload.png)
|
||||
|
||||
![choosequestionfromquestionbank](../images/choosefromquesbank.jpg)
|
||||
The question bank will appear in the list of question banks.
|
||||
Please, note that currently, the Assessment App supports question banks only in JSON format.
|
||||
|
||||
* Choose Participants.
|
||||
## How to browse the Assessment Analytics <a name="assessment-analytics"/>
|
||||
|
||||
![chooseparticipants](../images/chooseparticipants.jpg)
|
||||
When you published an assessment and students completed it, you can browse the Assessment Analytics.
|
||||
|
||||
* Click **Save changes**.
|
||||
To access the Assessment Analytics, select the assessment which you would like to see insights for and click **Analytics**.
|
||||
![assessmentanalytics](../images/assessmentanalytics.png)
|
||||
|
||||
![savechanges](../images/savechanges.jpg)
|
||||
You can see two charts:
|
||||
|
||||
1. **Histogram** - the chart shows the distribution of student results based on their score.
|
||||
|
||||
![histogram](../images/histogram.jpeg)
|
||||
|
||||
2. **Stacked Bar Chart** - the chart shows the proportion of correct and incorrect answers of each question.
|
||||
|
||||
![barchart](../images/barchart.jpeg)
|
||||
|
|
Загрузка…
Ссылка в новой задаче