diff --git a/.gitignore b/.gitignore index 97a74ad..9778607 100644 --- a/.gitignore +++ b/.gitignore @@ -10,3 +10,4 @@ cli.log .error_schema.log sphinx_settings.json /logs +generated-assets diff --git a/assets/Figures/add_instructor.png b/assets/Figures/add_instructor.png index aa3f46c..3fd9741 100644 Binary files a/assets/Figures/add_instructor.png and b/assets/Figures/add_instructor.png differ diff --git a/assets/Figures/course_settings.png b/assets/Figures/course_settings.png index 0f1f0ce..d7c28f2 100644 Binary files a/assets/Figures/course_settings.png and b/assets/Figures/course_settings.png differ diff --git a/assets/Figures/gradebook.png b/assets/Figures/gradebook.png new file mode 100644 index 0000000..bb5e539 Binary files /dev/null and b/assets/Figures/gradebook.png differ diff --git a/assets/Figures/gradebook_drilldown.png b/assets/Figures/gradebook_drilldown.png new file mode 100644 index 0000000..d848559 Binary files /dev/null and b/assets/Figures/gradebook_drilldown.png differ diff --git a/assets/Figures/grader1.png b/assets/Figures/grader1.png new file mode 100644 index 0000000..a69228d Binary files /dev/null and b/assets/Figures/grader1.png differ diff --git a/assets/Figures/grader2.png b/assets/Figures/grader2.png new file mode 100644 index 0000000..44432bc Binary files /dev/null and b/assets/Figures/grader2.png differ diff --git a/assets/Figures/import_assignments.png b/assets/Figures/import_assignments.png new file mode 100644 index 0000000..54925c2 Binary files /dev/null and b/assets/Figures/import_assignments.png differ diff --git a/assets/Figures/lti1_config.png b/assets/Figures/lti1_config.png new file mode 100644 index 0000000..99cea41 Binary files /dev/null and b/assets/Figures/lti1_config.png differ diff --git a/assets/Figures/manual_grading.png b/assets/Figures/manual_grading.png index fb97ae6..ec31949 100644 Binary files a/assets/Figures/manual_grading.png and b/assets/Figures/manual_grading.png differ diff --git a/assets/Figures/student_management.png b/assets/Figures/student_management.png index aabd179..ef7bb8a 100644 Binary files a/assets/Figures/student_management.png and b/assets/Figures/student_management.png differ diff --git a/pretext/Assignments/assembleAssignment.ptx b/pretext/Assignments/assembleAssignment.ptx index 39ae6c5..ea89963 100644 --- a/pretext/Assignments/assembleAssignment.ptx +++ b/pretext/Assignments/assembleAssignment.ptx @@ -104,6 +104,7 @@ alt="Choose Exercises" /> +
You can use the "All Exercises" toggle at the top to switch to just the "Book Exercises" to filter by just exercises that appear in the book. There are also exercises contributed by the teacher community.
Scroll to the chapter and subchapters that you want and click on the triangles next to them to expand them. When you see the exercises, you can click to choose them or click the eye to preview them before choosing. Exercises can be from the ebook that you are using, written by its author, or contributed by the community. @@ -128,8 +129,8 @@
Autograde: options here are % correct, All or nothing, Interaction, or manual. If the exercise has unit test autograding code, - it will be set to "% correct". If it does not have autograding, it will be set to manual, where you will need to grade it.
+Autograde: options here are Pct Correct, All or nothing, Interaction, or manual. If the exercise has unit test autograding code, + it will be set to "Pct Correct". If it does not have autograding, it can be set to Interaction only where just interacting with it gives the points or manual, where you will need to grade it.
Which to Grade: Best Answer, first answer or last answer
@@ -154,13 +155,27 @@ alt="Search Exercises" /> -When you are done adding exercises, click on the back arrow by the assignment name or on the Assignment Builder button at the top to return to the main assignment list page. By default, the new assignment will not be visible to students.
+Make sure you do not accept all the exercises in a lesson without toggling for "Book exercises" because there may be many community-added ones that may or may not work! When you are done adding exercises, click on the back arrow by the assignment name or on the Assignment Builder button at the top to return to the main assignment list page. By default, the new assignment will not be visible to students.
Please make sure that you slide the visibility toggle of an assignment in the assignments list to visible when you want your students to see it. If you forget to toggle this to visible, then the assignment will not show up in the list that your students can see on the assignment page.
For exercises in an assignment to be autograded, the assignment must be visible and + completed beforethe deadline while the students are working on it, and the exercises must be + the type of exercises that support autograding. For example, the book active code exercises + in the ebooks CSAwesome and CSAwesome2 all have unit tests + that support autograding, but the community-contributed exercises and exercises from other + books might not have unit tests. When you add an active code exercise to an assignment, you can + tell if it has autograding tests if it comes up as "Pct Correct" in the Autograde colum and + presents the autograding test results when run. Otherwise, it can be added as "interaction" + only without grading for correctness or for "manual" grading. Short answer questions can be + autograded for interaction, but require manual grading for content.
+ +You may have multiple sections where you want to share assignments, or you may simply want to copy your assignments from the last time you taught a course to your current course. Choose "Copy Assignment" from the Instructor Dashboard under the "Assignments & Grading" menu. Before copying assignments, it is a good idea to make sure that the course settings has the correct start date in the "Course Settings" in the "Course Administration" menu of the Instructor Dashboard so that the due dates are adjusted properly.
+You may have multiple sections where you want to share assignments, or you may simply want to copy your assignments from the last time you taught a course to your current course or + you may want to copy assignments provided by a base course. + There is a new Import button at the top right of the screen available in the Assignment Builder in the Instructor Dashboard. You can select whether to restrict the list of courses to "Only for this book" or "Only for courses I teach" with the toggles at the top. Open the drop down next to a course name to choose specific assignments or all. +
+Or you can choose "Copy Assignment" from the Instructor Dashboard under the "Assignments & Grading" menu. Before copying assignments, it is a good idea to make sure that the course settings has the correct start date in the "Course Settings" in the "Course Administration" menu of the Instructor Dashboard so that the due dates are adjusted properly.
Help, this is my first time teaching this class and I want to copy assignments from another instructor. This is very possible if the instructor is still available. You simply need to enroll in their course and have them make you a TA. Then you will be able to copy the assignments from their course to yours.
-If the previous instructor is not available then we can still probably make it happen, but you are going to have to go out of your way to prove that your request is legit. Sorry, we cannot just take your word for it over email. A link to your faculty page, that verifies your email as a legitimate instructor at the same institution of the instructor of the course you want to copy. We would love to just trust everyone, but data privacy laws are strict and we have to to treat data privacy very carefully. Thanks for understanding.
+You can now ask the other instructor to go to Course Settings and share their assignments with you, which you can then Import through the Assignment Builder.
To grade student performance, go back to the instructor's interface and click on the grading tab. You'll see something like this.
-Typically, you will select an assignment from the first dropdown. This will show you summary of the elements that are automatically graded. The other option is Chapter and you can use this to drill in on a chapter and look at a students work on any problem in the textbook regardless of whether it was part of an assignment.
-From here you can also select a question or questions as well as a student or students to manually grade a problem. You can also use this to view a students answer to an automatically graded problem if they have a question about their score.
-You will see the last version of code that the student ran prior to the assignment deadline. Click run to execute it. Drag the little scrubber across the timeline next to the Run button to see other versions of the code that the student ran.
-You can assign a number grade (number of points) and, optionally, leave a comment. As you tab out of the grade box you will see it turn green to indicate that the grade has been updated in the database. Similarly if you leave a comment it will automatically update the database with the comment for the student.
-If you prefer to work on one question at a time there is a save and next button that will automatically move on the next item to grade.
-Some questions have been configured for auto-grading, in particular coding problems with unit tests and some multiple choice problems. If you click on the Autograde button on the left side, the autograder will run. It will pop up an alert box to give you a diagnostic about how many question-student pairs were autograded.
-Some things to note about the autograder:
+ +To see the Grade Book, go to the Instructor Dashboard and click on Grade Book.
+The gradebook allows filtering by students or assignments. If you click on a student's grade, you can drill down to see their performance on each exercise and override the grade total. You can click on each exercise to open them in the grader.
+ +Many assignments can be automatically graded, with the grades automatically appearing in the + gradebook. For exercises in an assignment to be autograded, the assignment must be visible and + completed before the deadline, and the exercises must be the type of exercises + that support autograding. For example, the book active code exercises in the ebooks CSAwesome and + CSAwesome2 all have unit tests that support autograding, but the community-contributed exercises + and exercises from other books might not have unit tests. When you add an active code exercise to + an assignment, you can tell if it has autograding tests if it comes up as "Pct Correct" in the + Autograde colum and presents the autograding test results when run. Otherwise, it can be added as + "interaction" only without grading for correctness or for "manual" grading. Short answer + questions can be autograded for interaction, but require manual grading for content.
+ +For assignments that are not autograded, you can manually grade the students' work. You can also manually grade any assignment, even if it is autograded, to override the automatic grading or for late work after the deadline.
+ +To grade or examine student work, click on the Grader button in the Instructor's Dashboard. + You will see your assignments in the Cards View. You can switch to the Table View by clicking on the Table View button at the top right, and then you can search for an assignment by name or description. You can also sort the assignments by clicking on the column headers. + +
+Click on an assignment to view the problems in the assignment in Cards or Table view. In this + view, there are options to select all of the problems and Regrade all and to release the grades + to the students.
+ +From here, you can also select an exercise to view student solutions and to manually grade + them. In the manual grading view, you can see the students' solutions, override autograded + scores, and provide comments.
+ ++ In active code exercises, this view will show the last version of code that the student ran prior to the assignment deadline. + Click run to execute it. Drag the little scrubber across the timeline next to the Run button to + see other versions of the code that the student ran.
+ ++ You can assign or change the grades next to "Points" in the rightmost panel, and, optionally, + leave a comment. If you erase the "autograded" comment, it will no longer be autograded on regrades. Once you have manually graded the assignment or released grades, they will no longer + be autograded. You will need to run the grader again for late work. +
+ +When you are satisfied that the grades have been calculated correctly, click on the toggle + "Grades Hidden" button at the top right of the assignment view showing all the exercises in an + assignment in the Grader, to switch it to Released. This makes them visible to students.
+-
If a question is selected, the autograder will run only for that question.
-If a student is also selected, the autograder will run for only that question-student combination.
-To run the autograder for all the questions and students for a particular assignment, refresh the page, select the assignment, and click the autograde button before selecting a question or student.
-You can manually override the grade assigned by the autograder using the grading form on the right side. Be sure to change the comment as well.
-If you rerun the autograder, it will not run on any student-question pair where you have changed the comment.
-Once you have graded all the questions on an assignment, click the Caclulate Totals button to compute the total scores for the whole assignment, or to recalculate them after updating a grade. Again, an alert box will pop up to provide diagnostics about the min and max scores that were calculated.
-When you are satisfied that the grade totals have been calculated correctly, click on the Release Grades button at the bottom left. This makes them visible to students. If you make any subsequent changes to grades, you will need to click Calculate Totals again, but you will not need to click on Release Grades again: once released, they stay released.
-When viewing an assignment, a student can click on the Show Feedback
button to see a score and any instructor comments.
In addition the user menu allows the student to see a summary of their progress.
-If you prefer to start grading by student and drill down instead of starting with the + assignments, start with the Gradebook interface and click on a student's score in an assignment + to see a breakdown, and click on a specific problem to view the student's solution in the Grader.
+If you decide you don't want to use LTI you can remove that message and display the student assignments as usual by deleting the LTI keys you created when you set up LTI.
-
- The choose assignment page shows the status of the assignment. Students are encouraged to use this to keep themselves organized. They can mark an assignment as
The image below shows the choose assignment page. The student can see that two assignments have been graded and one assignment is "in progress." This makes it easier for students to know where they are it with each homework assignment, but to repeat has no actual bearing on grading. -
- -While Runestone is not (yet) smart enough to automatically mark a students assignment in progress, the student can set toggle through the status values by clicking the button at the bottom of the assignment page.
-The values for the status will toggle through the following options: -
Go to the instructor page and select the Add TA tab as shown below
+From the user icon at the top right of the page, choose the Instructor Dashboard. + Open the "Course Administration" section, and click on "Manage Teaching Assistants".
To "demote" a co-instructor or TA back to a student just select them in the list of instructors on the left and click the - button below the box.
+To "demote" a co-instructor or TA back to a student just select them in the list of instructors on the left and click the Remove button below the box.
\ No newline at end of file diff --git a/pretext/Registration/course_settings.ptx b/pretext/Registration/course_settings.ptx index cc7b36c..003282a 100644 --- a/pretext/Registration/course_settings.ptx +++ b/pretext/Registration/course_settings.ptx @@ -1,6 +1,6 @@There are some settings that you can control for your course that effect how the interactive components work. You can modify these on the course settings tab of the instructor interface.
+There are some settings that you can control for your course that effect how the interactive components work. From the user icon, choose the "Instructor Dashboard", then open the "Course Administration" section and click on "Course Settings".
@@ -21,6 +21,32 @@
Questions such as multiple choice may let students see how they did compared to other students in the class. This button pops up a dialog that shows the percent of students that answered a question for each option. For a fill in the blank question it shows the top 10 answers.
Display points instead of percentages (default is percent)
+Allow per-question LLM chat mode selection in asynchronous peer instruction activities. Requires an LLM API key.
+When enabled, student pages can use book-specific template overrides.
+Set the default group size for peer instruction activities
+Let instructors in other courses find and import your assignments. This covers every assignment in the course, exams included, so leave it off if any of them should stay private. Importing never copies student work or grades, and the instructor who imports gets their own hidden copy. You can write a note to instructors who import your assignments.
+Browse to the
-
From the user icon on the top right, choose Instructor Dashboard.
+Click on the "External Tools" section and click on "Connect my Learning Management System".
+ + +In this week's update I want to tell you about some new account management features I added to Runestone, and give you some idea about how you could set up your class if you don't want Runestone to capture any Personally Identifiable Information (PII) about your students.
-Runestone collects a lot of data. I think it is all justified, and if you are an instructor you can gain some real insight into how your students are doing based on the data we collect and the reports we create for you. None of that requires any PII about your students. Yet we do collect some… what do we collect? and why?
+Runestone allows you to set up your class without collecting any Personally Identifiable Information (PII) about your students.
+Runestone collects usage data but not PII. If you are an instructor you can gain some real insight into how your students are doing based on the data we collect and the reports we create for you. None of that requires any PII about your students. Yet we do collect some… what do we collect? and why?
Here is what we we ask for when a student registers:
It is important that you check your CSV file and make sure there are NO SPACES before or after the commas!
-From the Manage Students tab on the Instructor's Page, you can now upload this CSV file using the interface.
+From the Instructor's Dashboard, open the Student Management section, and click on Manage Students. you can now upload this CSV file using the interface.