From eb203f60fb5e91961b779f57a2cca802cf04ed90 Mon Sep 17 00:00:00 2001 From: Hayley Boyce <42727648+hfboyce@users.noreply.github.com> Date: Wed, 12 Feb 2020 11:36:35 -0800 Subject: [PATCH] added multiple choice part --- docs/index.md | 70 +++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 57 insertions(+), 13 deletions(-) diff --git a/docs/index.md b/docs/index.md index 3885ffd..01223c8 100644 --- a/docs/index.md +++ b/docs/index.md @@ -10,10 +10,9 @@ Ines Montani has created this framework using Gatsby and Reveal.js in the front- This project is under active development and there are possibilities of changes. If you would like to contribute or point out corrections, please create a new issue addressing your concern, suggestions or contribution. [![](https://user-images.githubusercontent.com/13643239/56341448-68fe9380-61b5-11e9-816f-5c71ae71b94f.png)](https://course-starter-python.netlify.com) -๐Ÿ”†This symbol will be used in this guide for helpful tips/recomendations and suggestions when building your course. -๐Ÿ›‘ -โš ๏ธ Testing emoji -๐Ÿšจ +๐Ÿ”†Hot Tips: This symbol will be used in this guide for helpful tips/recomendations and suggestions when building your course. +โš ๏ธ Warning: This symbol will give you preventative tips to avoid debugging or issues that I definitely ran into. + ## What To Expect @@ -131,7 +130,7 @@ This should a single command to complete this and will install Gatsby globally o ``` npm install -g gatsby-cli ``` -***NOTE: you will not need to update your dependencies here.*** +***โš ๏ธ Warning: Do not update your dependencies here.*** ### Clone or Install the Repository @@ -151,7 +150,7 @@ Next, we must install all relevant dependencies by running the following: npm install ``` -***NOTE: you will be prompted to `run "npm audit fix" to fix them`. +***โš ๏ธ Warning: You will be prompted to `run "npm audit fix" to fix them`. I do not recommend doing this as it will burn your site down.*** The output below will still build your course: @@ -475,7 +474,7 @@ You'll also notice we are calling a source file to display our slides. These sli [Ines explaines](https://github.com/ines/course-starter-python#slides) how your slide mardown document should be structured. -***WARNING: Be wary of trailing spaces ๐Ÿ˜ต๐Ÿ˜ฑ!! Although ```---``` may appear to be the same as ```--- ``` they are not and any information placed after the latter will break your slides.*** +***โš ๏ธ Warning: Be wary of trailing spaces ๐Ÿ˜ต๐Ÿ˜ฑ!! Although ```---``` may appear to be the same as ```--- ``` they are not and any information placed after the latter will break your slides.*** #### Enbedding Video and Audio @@ -504,7 +503,7 @@ _`audio-file-name.mp3` should be living in the `static` folder._ ### Multiple choice questions: -In a similar style to slide you will have code that looks like the following +In a similar style to slides you will have code for questions that looks like the following: ``` @@ -514,13 +513,13 @@ Insert questions here. -Great job! Training on training data must be done before predicting on new data. +Great job! -How can the model predict without education first? +Try again! This is incorrect. @@ -528,12 +527,57 @@ How can the model predict without education first? ``` - Your question text will live in the ``. - You can then specify the solution options that correspond to this question using ``. -- Each option will live in ``. If you want to specify a solution option as correct you can give it an argument `correct="true"` otherwise if it's wrong, no argument is needed. ๐Ÿ”†***You may have multiple right answers in a question*** +- Each option will live in ``. If you want to specify a solution option as correct you can give it an argument `correct="true"` otherwise if it's wrong, no argument is needed. ***๐Ÿ”†You can have multiple right answers in a question*** + + +***โš ๏ธ Warning: You must have padding (empty lines) above and below your question text as well as your answer feedback text as shown above._ + +#### ๐Ÿ”†You can have several questions in one exercise container + +![](img/multi-q-exercise.png) + Source: Hayley Boyce @ UBC MDS from https://mcl-dsci-571-intro-machine-learning.netlify.com/module1 + + +The key to having several questions in one exercise container is to give `` an id. +``` +exercise id="18" title= "Mutiple questions in one exercise"> + +Question 1 here. + + + + +Incorrect. + + + + + +Great! + + + + +Question 2 here + + + + +Incorrect. + + -_Note: You must have padding (empty lines) above and below your question text as well as your answer feedback text as shown above._ + -If you wish to specify the correct answers +Great! + + + + + + +``` ### Codeblock Exercises: