-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
add a general guideline and 210 + 330 details
- Loading branch information
Showing
4 changed files
with
78 additions
and
56 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,67 +1,15 @@ | ||
| # CPSC 210 - Software Construction | ||
|
|
||
| Each term we would like to allocate a few TAs to help us develop some randomized questions on PrairieLearn for three ultimate goals: | ||
| Below are some additional notes and details specifically for CPSC 210. | ||
|
|
||
| 1. Develop an infrastructure for question development between terms | ||
| 1. Move to a frequent testing paradigm in CPSC 210 (4 or 5 quizzes vs. 2 midterms) | ||
| 1. Allow for self-reservation quizzes in the CBTF (quizzes run over a multi-day window to give students different questions) | ||
|
|
||
| ## Training | ||
|
|
||
| To start developing questions on PrairieLearn requires a bit of setup, reading, and watching videos. | ||
| We have started developing some resources for this since it is a fairly involved process. | ||
| [Here is a link to the training resources]: | ||
|
|
||
| ### Suggested Order of the Training | ||
|
|
||
| - 1. "[What is PrairieLearn](https://firas.moosvi.com/oer/pl_guides/content/pl/intro.html)" Section | ||
| - Tour of PrairieLearn (video: ~30 mins - watch at 1.5x speed) | ||
| - Structure of PrairieLearn (video: ~3.5 mins) | ||
|
|
||
| - 1. "[Question Development](https://firas.moosvi.com/oer/pl_guides/content/authoring/creating_q.html)" Section | ||
| - Creating a PrairieLearn question (video: ~15 mins) | ||
| - Tips for Randomizing Questions (reading) | ||
| - Randomization Framework (reading) | ||
|
|
||
| - 1. "[Local PrairieLearn course development (Docker)](https://firas.moosvi.com/oer/pl_guides/content/pl_docker/preparation.html)" Section | ||
| - Preparation (reading) | ||
| - Forking a PrairieLearn course for local development (reading) | ||
| - PrairieLearn Course Development on Docker (reading) | ||
|
|
||
| ## Check-in with Instructors in the `#prairielearn` Slack channel | ||
|
|
||
| At this point, once you're confident you've got things setup, please let us know. | ||
| Ideally you'd finish up to here before our first meeting together. | ||
|
|
||
| ## Next Steps | ||
|
|
||
| ### Look at some Documentation | ||
|
|
||
| - [pl-question-panel element](https://prairielearn.readthedocs.io/en/latest/elements/#pl-question-panel-element) | ||
| - [pl-answer-panel element](https://prairielearn.readthedocs.io/en/latest/elements/#pl-answer-panel-element) | ||
| - [pl-checkbox element](https://prairielearn.readthedocs.io/en/latest/elements/#pl-checkbox-element) | ||
| - [pl-dropdown element](https://prairielearn.readthedocs.io/en/latest/elements/#pl-dropdown-element) | ||
| - [pl-multiple-choice element](https://prairielearn.readthedocs.io/en/latest/elements/#pl-multiple-choice-element) | ||
| - [pl-number-input](https://prairielearn.readthedocs.io/en/latest/elements/#pl-number-input-element) | ||
| - [pl-string-input elements](https://prairielearn.readthedocs.io/en/latest/elements/#pl-string-input-element) | ||
| - [Review Mustached Syntax](https://mustache.github.io/mustache.5.html) | ||
|
|
||
| ### Explore existing questions in the CPSC 210 course | ||
| ## Existing questions in CPSC 210 | ||
|
|
||
| For your convenience, relevant questions have been moved into this directory: `questions/2023W1/midterm1` | ||
| For TAs working on questions for "Part 1" (multiple choice, checkbox, drop downs, fill in the blanks) of the Midterms/Exams, you should explore those questions. | ||
| For TAs working on questions for "Part 2" (Workspaces and autograded questions) of the Midterms/Exams, you should explore questions from both Part 1 and Part 2. | ||
|
|
||
| TAs working on questions for Part 2 will need some additional training and instruction, which will be provided at a later date. | ||
|
|
||
| ### Create a new multiple choice question | ||
|
|
||
| Your first task after going through the training is to create a fully randomized multiple choice question from scratch. | ||
| You should thoroughly test the question locally in a Docker environment, in your own course (IND 100). | ||
| Once you're ready for us to take a look at your course, submit a Pull Request in this repository to add it into the correct directory (for e.g., `cpsc210-instructors/questions/2023W2/practice/your_question`). | ||
|
|
||
| That's it! Thanks for making it this far! | ||
|
|
||
| ## Feedback | ||
| ## Training for Part 2 questions | ||
|
|
||
| If you have suggestions or clarification requests for the [instructions](https://firas.moosvi.com/oer/pl_guides/content/pl_docker/preparation.html) (particularly the Docker guide), please feel free to let me know, or even better, submit a Pull Request [in the repo](https://github.com/open-resources/pl_guides)! | ||
| Coming soon... |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,7 @@ | ||
| # CPSC 330 - Applied Machine Learning | ||
|
|
||
| Below are some additional notes and details specifically for CPSC 330. | ||
|
|
||
| ## Additional Tasks | ||
|
|
||
| - Develop a taxonomy and tagging system so that existing questions can be tagged, and so we can figure out where there are gaps. [See here for details](https://firas.moosvi.com/oer/physics_bank/files/home.html#questions-by-topics) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,65 @@ | ||
| # General | ||
|
|
||
| Each term we would like to allocate a few TAs to help us develop some randomized questions on PrairieLearn for three ultimate goals: | ||
|
|
||
| 1. Develop an infrastructure for question development between terms | ||
| 1. Move to a frequent testing paradigm | ||
| 1. Allow for self-reservation quizzes in the CBTF (quizzes run over a multi-day window to give students different questions) | ||
|
|
||
| ## Training | ||
|
|
||
| To start developing questions on PrairieLearn requires a bit of setup, reading, and watching videos. | ||
| We have started developing some resources for this since it is a fairly involved process. | ||
| [Here is a link to the training resources]: | ||
|
|
||
| ### Suggested Order of the Training | ||
|
|
||
| - 1. "[What is PrairieLearn](https://firas.moosvi.com/oer/pl_guides/content/pl/intro.html)" Section | ||
| - Tour of PrairieLearn (video: ~30 mins - watch at 1.5x speed) | ||
| - Structure of PrairieLearn (video: ~3.5 mins) | ||
|
|
||
| - 1. "[Question Development](https://firas.moosvi.com/oer/pl_guides/content/authoring/creating_q.html)" Section | ||
| - Creating a PrairieLearn question (video: ~15 mins) | ||
| - Tips for Randomizing Questions (reading) | ||
| - Randomization Framework (reading) | ||
|
|
||
| - 1. "[Local PrairieLearn course development (Docker)](https://firas.moosvi.com/oer/pl_guides/content/pl_docker/preparation.html)" Section | ||
| - Preparation (reading) | ||
| - Forking a PrairieLearn course for local development (reading) | ||
| - PrairieLearn Course Development on Docker (reading) | ||
|
|
||
| ## Check-in with Instructors | ||
|
|
||
| At this point, once you're confident you've got things setup, please let us know. | ||
| Ideally you'd finish up to here before our first meeting together. | ||
|
|
||
| ## Next Steps | ||
|
|
||
| ### Look at some Documentation | ||
|
|
||
| - [pl-question-panel element](https://prairielearn.readthedocs.io/en/latest/elements/#pl-question-panel-element) | ||
| - [pl-answer-panel element](https://prairielearn.readthedocs.io/en/latest/elements/#pl-answer-panel-element) | ||
| - [pl-checkbox element](https://prairielearn.readthedocs.io/en/latest/elements/#pl-checkbox-element) | ||
| - [pl-dropdown element](https://prairielearn.readthedocs.io/en/latest/elements/#pl-dropdown-element) | ||
| - [pl-multiple-choice element](https://prairielearn.readthedocs.io/en/latest/elements/#pl-multiple-choice-element) | ||
| - [pl-number-input](https://prairielearn.readthedocs.io/en/latest/elements/#pl-number-input-element) | ||
| - [pl-string-input elements](https://prairielearn.readthedocs.io/en/latest/elements/#pl-string-input-element) | ||
| - [Review Mustached Syntax](https://mustache.github.io/mustache.5.html) | ||
|
|
||
| ### Explore existing questions and assessments | ||
|
|
||
| Have a look through the `questions` directory for existing questions in the course so you can get a sense of the style of questions. | ||
|
|
||
| You can look at the `courseInstasnces/assessments/` directory to see how assessments are created and how questions are added to courses. | ||
|
|
||
| ### Create a new multiple choice question | ||
|
|
||
| Your first task after going through the training is to create a fully randomized multiple choice question from scratch. | ||
| You should thoroughly test the question locally in a Docker environment, in your own course (IND 100). | ||
| Once you're ready for us to take a look at your course, submit a Pull Request in this repository to add it into the correct repository and location (for e.g., `pl-ubc-cpscXXX/questions/202XW2/training/your_question`). | ||
|
|
||
| That's it! Thanks for making it this far! | ||
|
|
||
| ## Feedback | ||
|
|
||
| If you have suggestions or clarification requests for the [instructions](https://firas.moosvi.com/oer/pl_guides/content/pl_docker/preparation.html) (particularly the Docker guide), please feel free to let me know, or even better, submit a Pull Request [in the repo](https://github.com/open-resources/pl_guides)! |