This commit is contained in:
Victoria Demina 2021-09-17 17:43:08 +01:00 коммит произвёл GitHub
Родитель 5368e1e38f
Коммит 33787108e9
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
1 изменённых файлов: 87 добавлений и 28 удалений

Просмотреть файл

@ -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)