diff --git a/docs/student/faq.md b/docs/student/faq.md index 9f8879151..597a9f8e1 100644 --- a/docs/student/faq.md +++ b/docs/student/faq.md @@ -1,6 +1,6 @@ # Frequently Asked Questions -## Why I cannot find the module I am looking for? +## Why can't I find the module I am looking for? Access to each module is provided by the teacher owning the module. diff --git a/docs/student/images/pdf_button.png b/docs/student/images/pdf_button.png index 55cc01871..236a9430b 100644 Binary files a/docs/student/images/pdf_button.png and b/docs/student/images/pdf_button.png differ diff --git a/docs/student/images/question_overview.png b/docs/student/images/question_overview.png index 514164f57..e762f7285 100644 Binary files a/docs/student/images/question_overview.png and b/docs/student/images/question_overview.png differ diff --git a/docs/student/index.md b/docs/student/index.md index e2bf925b1..8d4d19b38 100644 --- a/docs/student/index.md +++ b/docs/student/index.md @@ -17,9 +17,10 @@ The image above shows an example question, with numbers to indicate: 8. Part selection (tabs) 9. _Part content_ (only visible when relevant part is open - (a),(b), etc.) 10. _Response area_, where student responses are entered and feedback is given -11. Feedback to the teacher (currently in flux regarding the design - 31/8/22) +11. Feedback to the teacher (currently in flux regarding the design - 02/07/25) 12. Access to content 'below the line' providing extra support. - +13. _Workspace_ - Opens tab with canvas and ai chatbot +14. Comments ## Below the line @@ -27,7 +28,6 @@ The image above shows an example question, with numbers to indicate: ![Below the line buttons screenshot](images/Traffic_Light_Only.png){: style="height:50px"} -- _My solutions_ - create your own content. Drag and drop images or type content. Use standard markdown. - _Structured tutorial_ - teachers use this in different ways. It is generally a way to provide scaffolding if you're struggling. - _Final Answer_ - warning, don't ever look at the answer before you make your own genuine attempt at answering the question. -- _Worked solutions_ - warning, don't ever look at the solutions before you make your own attempt. If necessary, look at the first line and reveal a step at a time. \ No newline at end of file +- _Worked solutions_ - warning, don't ever look at the solutions before you make your own attempt. If necessary, look at the first line and reveal a step at a time. diff --git a/docs/teacher/guides/content-sets-questions.md b/docs/teacher/guides/content-sets-questions.md index 5a6a147c6..e9427822b 100644 --- a/docs/teacher/guides/content-sets-questions.md +++ b/docs/teacher/guides/content-sets-questions.md @@ -1,25 +1,23 @@ # Editing questions -In this guide, we will walk through how to create [sets](https://lambda-feedback.github.io/user-documentation/terminology#sets) and [questions](https://lambda-feedback.github.io/user-documentation/terminology#questions). +This guide explains how to use the editor to create and modify [sets](https://lambda-feedback.github.io/user-documentation/terminology#sets) and [questions](https://lambda-feedback.github.io/user-documentation/terminology#questions). -1. Click on a Set in order to edit or add questions. +## Click a Set to edit or add questions to it. + ![](./images/content-sets-questions-10.png) - ![set panel entry](./images/content-sets-questions-10.png) +## A guide to the editor: + ![](./images/content-sets-questions-11.png) -2. A guide to the editor: - - ![set panel entry](./images/content-sets-questions-11.png) - - | Label | Name | Description | - | ----- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - | 1 | Question Name | Here we can edit the name given to the question | - | 2 | Master content | Always visible. Uses a milkdown component. | - | 3 | Current part | References which question part we are editing. | - | 4 | Part Content | Here we can edit the specific content of the part (the sub question). | - | 5 | Response Area | This is the means by which the student answers a given question. It is optional to include a response area. | - | 6 | Question Help Options | Here we may add a [Structured Tutorial](https://lambda-feedback.github.io/user-documentation/terminology#structured-tutorial), a [Final Answer](https://lambda-feedback.github.io/user-documentation/terminology#final-answer) ("Show Answer"), or [Worked Solutions](https://lambda-feedback.github.io/user-documentation/terminology#worked-solution). These buttons are also how the student will see them, hence the name of "Show Answer". | - | 7 | Teacher-Student View Toggle | Here we may toggle between the teacher view ("EDIT"), and the student view ("PREVIEW"). This way we can edit the question, but also see a preview of how it would look to the student. | - | 8 | Edit Guidance | Here we can add further details for guidance, estimated working time and skill level. | - | 9 | Part option | Here we can add, duplicate or (if there are more than one) delete a question part. | - | 10 | Add question | Here we can add create a new blank question, duplicate a question or upload a zip file containing JSON file(s) for Lambda Feedback. | - | 11 | File, Preview and Stats | Travel to pages to a) File: version management/ download as JSON and delete question b) Preview: view the question as a student would see it c) Stats: View stats of student responses of the question set. | +| Label | Name | Description | +| :--- | :--- | :--- | +| **1** | **Add Question** | Add a new blank question, duplicate an existing question, or upload a .zip file containing one or more question JSON files. | +| **2** | **File, Preview, and Stats** | Access pages for:
• **File:** Manage versions, download as a JSON file, or delete the question.
• **Preview:** See the question as a student would.
• **Stats:** View statistics on student responses for the question. | +| **3** | **Question Name** | Edit the name of the question. | +| **4** | **Master Content** | The main content for the question, which is always visible above the individual parts. This field uses the Milkdown editor. | +| **5** | **Current Part** | **Indicates** which question part you are currently editing. | +| **6** | **Part Content** | Edit the content for the selected question part (i.e., the sub-question). | +| **7** | **Response Area** | The input field where a student submits their answer. Adding a response area is optional. | +| **8** | **Question Help Options** | Add optional support materials for students, such as a [**Structured Tutorial**](https://lambda-feedback.github.io/user-documentation/terminology#structured-tutorial), a [**Final Answer**](https://lambda-feedback.github.io/user-documentation/terminology#final-answer), or [**Worked Solutions**](https://lambda-feedback.github.io/user-documentation/terminology#worked-solution). The buttons shown here are the same ones students will see. | +| **9** | **Teacher/Student View Toggle** | Toggle between the teacher editing view ('EDIT') and the student 'PREVIEW' to see how the question will appear to students. | +| **10** | **Edit Guidance** | Add extra details for the question, such as guidance notes, estimated completion time, and skill level. | +| **11** | **Part Options** | Add a new part, duplicate the current part, or delete a part (only available if there is more than one). | diff --git a/docs/teacher/guides/gettingstarted.md b/docs/teacher/guides/gettingstarted.md index 7b63ef27f..f28c12875 100644 --- a/docs/teacher/guides/gettingstarted.md +++ b/docs/teacher/guides/gettingstarted.md @@ -1,83 +1,101 @@ -# Get started as a teacher using Lambda Feedback +# Getting Started with Lambda Feedback for Teachers -## Access a module +## Access a Module -Use your Imperial Microsoft account to sign in and access your modules. By default you are logged in as a student and the interface will be blue. If you have teacher priviliges then you will see a teacher button at the top. +Use your Imperial Microsoft account to sign in and access your modules. By default, you are logged in as a student, and the interface will be blue. If you have teacher **privileges**, you will see a 'Teacher' button at the top. ![Buttons](images/Student_Mode_Arrow.PNG)
-To enter teacher mode, click on the Teacher button, and the colour of the interface will change to orange. This is where you are able to access all your modules, as well as upload and edit problem sets. +To enter teacher mode, click the 'Teacher' button, and the **colour** of the interface will change to orange. This is where you can access all your modules, as well as upload and edit problem sets. -As of 07/2023, new modules can only be added to Lambda Feedback by administrators. Please speak to an admin if you wish for your module to be added to the website. +As of **July 2023**, new modules can only be added to Lambda Feedback by administrators. Please **contact an administrator** if you want your module added to the website. ![Teacher](images/Teacher_Mode_Orange.PNG)
-To find the module you want, you can sort ASCENDING as per the image below:
+To find the module you want, you can sort them in **ascending/descending order**, or filter them as shown below: +
![Sort](images/Sort_Modules.png){: style="height:200px"} ![Filter](images/Filter_Modules.png){: style="height:200px"}
-_Image: quick sort (left) or filtering (right)_ +_Image: Quick sort (left) or filtering (right)_ -As of 31/8/22 the filtering/sorting only works on the content visible on the current page (other pages are ignored). We aim to fix this by sorting at the backend. - -Select the module you wish to edit.
+Select the module you wish to edit. +
![Select module](images/Teacher_Module_Selection.png) -## Create a new problem set +## Create a New Problem Set -Click on your module and then click on "content" (upper left-hand corner).
+Click your module and then click 'Content' (in the upper-left corner). +
![View sets](images/Teacher_View_Sets2.png) -Create a new set by pressing the button seen below and this will automatically appear with a default name which you can edit by clicking 'edit set metadata':
-![Create set](images/create_set.png){: style="height:50px"} +Create a new set by **clicking** the 'Create Set' button. + +A menu will appear with options to edit the name, description, and other settings for the new set. -To edit the content, click on the set name. This will open the Set in a ['WYSIWYG'](https://en.wikipedia.org/wiki/WYSIWYG) editor. The first question is automatically created with a default name. +To edit the content, click the set name. This will open the set in a ['WYSIWYG'](https://en.wikipedia.org/wiki/WYSIWYG) editor. The first question is automatically created with a default name. The question structure is described [here](../../student/index.md). -## Below the line +## Below the Line -Below the main question content you can provide high quality support material for students. +Below the main question content, you can provide high-quality support material for students. ![Below the line buttons screenshot](../../student/images/Traffic_Light_Only.png){: style="height:50px"} -A [student guide is here](../../student/index.md) and teachers use the content as follows: +A [student guide is here](../../student/index.md). Teachers use the 'below the line' content as follows: -- **Structured tutorial** is a canvas to provide scaffolding to students struggling with the question. -- **Final answer** is self explanatory. -- **Worked solutions** provides detailed, step-by-step solutions. +- **Structured tutorial** is to provide scaffolding for students struggling with the question. +- **Final answer** is self-explanatory. +- **Worked solutions** provides detailed, step-by-step solutions. -All content below the line uses milkdown functionality. Worked solutions can be branched. Future developments will add branching and response areas to structured tutorials. +All content below the line uses Lexdown functionality. Worked solutions can be branched. Future developments will add branching and response areas to structured tutorials. -It is not necessary to include all three methods of help, if only one of the tabs is filled then only that one button will be included in the published student version. +It is not necessary to include all three methods of help. If you only provide content for one tab, only that button will appear in the published student version. For general terminology, see [here.](../../terminology.md) To see further details on how to edit your questions, see [here.](content-sets-questions.md) -## Enrolling students +## Enrolling Students + +In **Teacher mode**, open your module's home page, click the 'Students' tab, and then click 'Enrol Students'. + +![Teacher view students](../../teacher/guides/images/Teacher_view_students.png) + +Enter a student's email address, or alternatively paste in a list of email addresses separated by commas. + +![Add_student_before](./images/Add_student_before.png) -In TEACHER mode, open your module home page and click 'VIEW STUDENTS' then 'ENROL STUDENTS' +Press 'Enter' to add the email addresses: -![View students button](../../teacher/guides/images/view_students.png) ![Enrol students button](../../teacher/guides/images/enrol_students.png) +![Add_student_after](./images/Add_student_after.png) -Enter a comma-separated list of email addresses. Press 'Enter' to confirm the addresses, and then 'SUBMIT' to enrol the students +Then click 'SUBMIT' to enrol the students. -### Imperial College London email addresses +### Imperial College London Email Addresses -You must use the long form email address: +You must use the long-form email address: #### Valid: first.nameYY@imperial.ac.uk (student) +
j.doe@imperial.ac.uk (staff) +
first.name@imperial.ac.uk (staff) +
-#### Invalid +#### Invalid: abc123@ic.ac.uk +
abc123@imperial.ac.uk +
user@ic.ac.uk +
user@imperial.ac.uk +
first.nameYY@ic.ac.uk +
-The reason for the above is because we use Azure Active Directory - i.e. Microsoft - to authorise users. +This is because we use Azure Active Directory (i.e., Microsoft) to **authorise** users. diff --git a/docs/teacher/guides/images/Add_student_after.png b/docs/teacher/guides/images/Add_student_after.png new file mode 100644 index 000000000..10cf80d79 Binary files /dev/null and b/docs/teacher/guides/images/Add_student_after.png differ diff --git a/docs/teacher/guides/images/Add_student_before.png b/docs/teacher/guides/images/Add_student_before.png new file mode 100644 index 000000000..69c06bba1 Binary files /dev/null and b/docs/teacher/guides/images/Add_student_before.png differ diff --git a/docs/teacher/guides/images/Teacher_View_Sets.png b/docs/teacher/guides/images/Teacher_View_Sets.png deleted file mode 100644 index 239cb9a90..000000000 Binary files a/docs/teacher/guides/images/Teacher_View_Sets.png and /dev/null differ diff --git a/docs/teacher/guides/images/Teacher_View_Sets2.png b/docs/teacher/guides/images/Teacher_View_Sets2.png index de004f095..08b83767c 100644 Binary files a/docs/teacher/guides/images/Teacher_View_Sets2.png and b/docs/teacher/guides/images/Teacher_View_Sets2.png differ diff --git a/docs/teacher/guides/images/Teacher_view_students.png b/docs/teacher/guides/images/Teacher_view_students.png new file mode 100644 index 000000000..f68abcb7c Binary files /dev/null and b/docs/teacher/guides/images/Teacher_view_students.png differ diff --git a/docs/teacher/guides/images/content-sets-questions-11.png b/docs/teacher/guides/images/content-sets-questions-11.png index 21197d75c..fbc33613e 100644 Binary files a/docs/teacher/guides/images/content-sets-questions-11.png and b/docs/teacher/guides/images/content-sets-questions-11.png differ diff --git a/docs/teacher/guides/images/create_set.png b/docs/teacher/guides/images/create_set.png deleted file mode 100644 index 4936c12de..000000000 Binary files a/docs/teacher/guides/images/create_set.png and /dev/null differ diff --git a/docs/teacher/guides/images/view_sets.png b/docs/teacher/guides/images/view_sets.png deleted file mode 100644 index defb1b67c..000000000 Binary files a/docs/teacher/guides/images/view_sets.png and /dev/null differ diff --git a/docs/teacher/guides/images/view_students.png b/docs/teacher/guides/images/view_students.png deleted file mode 100644 index 1fbc14505..000000000 Binary files a/docs/teacher/guides/images/view_students.png and /dev/null differ