Skip to content
Snippets Groups Projects
checklist.md 10.1 KiB
Newer Older
wwarriner's avatar
wwarriner committed
# DSJC New Session Checklist

wwarriner's avatar
wwarriner committed
The course is a collaboration between Kristina Visscher of the UAB Department of Neurobiology and UAB IT Research Computing. The intent of the course is to provide a guided platform for self-motivated students to learn more about Data Science and its important accessory skills. Accessory skills include software development, programming, data engineering, image and signal processing, visualization development, and high performance computing.

The course runs every session each year: Fall, Spring, Summer. The UAB Academic Calendar dictates when classes start for each session. As instructors, our goal should be to have the course published the week before classes start.

## Course Setup Checklist

wwarriner's avatar
wwarriner committed
### Instructor of Record
wwarriner's avatar
wwarriner committed

- At least one month prior to start of classes, contact departments to get courses listed.
    - [ ] GBSC: Olivia Barnes (<ochood@uab.edu>)
    - [ ] IDNE: Kristina Barlow (<kbarlow@uab.edu>)
wwarriner's avatar
wwarriner committed
- [ ] Merge GBSC and IDNE sections.
wwarriner's avatar
wwarriner committed
    - Must be done by [IOR](#abbreviations).
wwarriner's avatar
wwarriner committed
    - Please visit [Canvas: Course Cross-Listing SLA page](https://uabprod.service-now.com/service_portal?id=sc_cat_item&sys_id=393e9275377d630024a67c1643990e27).
wwarriner's avatar
wwarriner committed
- [ ] Add course Teachers and Instructors as needed.
wwarriner's avatar
wwarriner committed
    - Must be done by [IOR](#abbreviations) _after_ merge step is complete! Otherwise, adds may need to be redone.
wwarriner's avatar
wwarriner committed
    - Please visit [Canvas: Add/Remove User(s) SLA page](https://uabprod.service-now.com/service_portal?id=sc_cat_item&sys_id=76f97b59374a670024a67c1643990ece).
wwarriner's avatar
wwarriner committed
    - Teacher/Instructor List:
        - `wwarr` for William Warriner
        - `mdefende` for Matt Defenderfer
wwarriner's avatar
wwarriner committed
        - `prema` for Prema Soundararajan
wwarriner's avatar
wwarriner committed

### Teachers/Other Instructors

- [ ] Set up the Syllabus Affirmation Assignment
    1. Navigate to Quizzes page.
William Warriner's avatar
William Warriner committed
    1. Click "+ Quiz" button.
    1. Select "Classic Quizzes".
    1. Click "Submit" button.
    1. Enter in first text entry box: `Syllabus Affirmation`.
    1. Enter in the "Quiz Instructions" text entry box:
        > In a new window, please read the Syllabus, then return here to complete the affirmation.
    1. Create a "Course Link" to the Syllabus Course Page at the word "Syllabus" in the previous step.
William Warriner's avatar
William Warriner committed
    1. Set the following field values in the remainder of the form.
        - Quiz Type: `Graded Quiz`
wwarriner's avatar
wwarriner committed
        - Assignment Group: `Assignments`
        - Options:
            - Shuffle Answers: `checked`
            - Time Limit: `unchecked`
            - Allow Multiple Attempts: `checked`
                - Quiz Score to Keep: `highest`
                - Allowed Attempts: `unchecked`
            - Let Students See Their Quiz Responses: `checked`
                - Only Once After Each Attempt: `checked`
                - Let Students See The Correct Answers: `unchecked`
wwarriner's avatar
wwarriner committed
            - Show one question at a time: `unchecked`
        - Quiz Restrictions:
            - Require an access code: `unchecked`
            - Filter IP Addresses: `unchecked`
wwarriner's avatar
wwarriner committed
        - Assign:
            - Assign to: `Everyone`
            - Due: Friday of 2nd week.
wwarriner's avatar
wwarriner committed
            - Available from/until: both blank
William Warriner's avatar
William Warriner committed
    1. Click "Questions" tab.
    1. Click "+ New Question".
wwarriner's avatar
wwarriner committed
        - In the top-left Text Entry box enter "First Demonstration Due Date"
        - In the Drop Down box select "Multiple Choice"
        - Enter the text "When is the first demonstration due?" in the main text entry box.
        - Make one answer the correct date (see the Syllabus for timings).
        - Make other answers other dates.
        - Click "Update Question".
William Warriner's avatar
William Warriner committed
    1. Click "Details" tab.
    1. Click "Save & Publish!" button.
wwarriner's avatar
wwarriner committed
- [ ] Set up the [Demonstration Assignment HTML](demonstration_assignment.html)
wwarriner's avatar
wwarriner committed
    1. Navigate to Assignments page.
William Warriner's avatar
William Warriner committed
    1. Click "+ Assignment" button.
    1. Enter Assignment Name in text entry box: `Demonstration #1`.
    1. Switch text entry box to raw HTML mode by clicking `</>` symbol at bottom-right of box.
    1. Copy-paste [HTML](demonstration_assignment.html) into text entry box.
    1. Switch text entry box back to WYSIWYG mode by clicking `</>` symbol at bottom-right of box.
    1. Create a "Course Link" to the Syllabus Course Page at the word "Syllabus" in the previous step.
    1. Check links.
William Warriner's avatar
William Warriner committed
    1. Set the following field values in the remainder of the form.
wwarriner's avatar
wwarriner committed
        - Points: `1`
wwarriner's avatar
wwarriner committed
        - Assignment Group: `Assignments`
wwarriner's avatar
wwarriner committed
        - Display Grade as: `Complete/Incomplete`
        - Submission Type: `No Submission`
        - Group Assignment: unchecked
        - Peer Reviews: unchecked
        - Assign:
            - Assign to: `Everyone`
wwarriner's avatar
wwarriner committed
            - Due: **varies, see table below**

                Assignment due dates should be staggered, with at least three weeks between them, always on a Friday. The following table contains due dates for each. You will need to determine the actual calendar dates for each semester. Be sure to account for Spring Break in the Spring semester, and Thanksgiving Break in the Fall semester! Don't set assignment due dates on holidays or break days, move it one business day later. So far, all sessions have been 14 weeks. The first assignment has extra time because it may take students time to get oriented to their chosen data science problems, especially if they are new to data science, etc.
wwarriner's avatar
wwarriner committed

                | Session Length | #1 Due Date | #2 Due Date | #3 Due Date |
                | -------------- | ----------- | ----------- | ----------- |
                | 14 weeks       | 6th week    | 10th week   | 14th week   |
                | 10 weeks       | 4th week    | 7th week    | 10th week   |

wwarriner's avatar
wwarriner committed
            - Available from/until: blank
    1. Click "Save and Publish" button.
    1. Duplicate to create `Demonstration #2` and `Demonstration #3`.
wwarriner's avatar
wwarriner committed
        1. Go to the main Assignments page.
William Warriner's avatar
William Warriner committed
        1. Click the vertical three dots next to the `Demonstration #1` assignment you created.
        1. Click "Duplicate".
        1. On the new entry, click the vertical three dots, then "Edit Assignment".
        1. Modify the "Name" and "Due Date" fields appropriately.
        1. For `Demonstration #3`, set the due date to be the last day of finals.
William Warriner's avatar
William Warriner committed
        1. Click "Save & Publish".
    1. Verify the assignments are published in the Assignments main page, with a green checkmark icon next to each.
wwarriner's avatar
wwarriner committed
- [ ] Upload [Syllabus HTML](syllabus.html)
    1. Navigate to Syllabus page.
William Warriner's avatar
William Warriner committed
    1. Switch text entry box to raw HTML mode by clicking `</>` symbol at bottom-right of box.
    1. Copy-paste [HTML](syllabus.html) into text entry box.
    1. Switch to WYSIWYG mode: click `</>` symbol again.
    1. Remove the title. The title is only used for sharing the Syllabus outside Canvas. Canvas produces its own title.
    1. Create a "Course Link" to the Assignments Course Page at the word "Assignments" in the Grading section.
    1. Ensure "Show Course Summary" checkbox is checked.
William Warriner's avatar
William Warriner committed
    1. Verify formatting is correct.
wwarriner's avatar
wwarriner committed
- [ ] Set up Home page.
    1. Navigate to Home page.
    1. Click "Choose Home Page" button in right panel.
    1. Select "Syllabus" and "Save".
wwarriner's avatar
wwarriner committed
- [ ] Set up Settings page.
wwarriner's avatar
wwarriner committed
    - Navigation tab:
        - Disable all except:
wwarriner's avatar
wwarriner committed
            - Home
            - Announcements
            - Syllabus
            - Assignments
            - Grades
            - People
            - UAB Cares
            - UAB Policies
            - UAB Libraries
wwarriner's avatar
wwarriner committed
            - Technology Resources
            - Student Academic and Support Services
        - Put them in the above order.
        - Click "Save" at the bottom when done.
wwarriner's avatar
wwarriner committed
- [ ] Verify links using "Validate Links in Content" on Settings page.
    - Note: `https://rc.uab.edu` may be marked as unreachable. Double check that it works correctly manually. This should be a false positive.
wwarriner's avatar
wwarriner committed
- [ ] Use Student View to verify the course has appropriate appearance and function.
wwarriner's avatar
wwarriner committed
    - Make sure syllabus looks correct.
    - Make sure assignments are visible (they need to be published individually).
- [ ] Publish the course. Should be done by IOR.
wwarriner's avatar
wwarriner committed
- [ ] Make an announcement welcoming new students.
wwarriner's avatar
wwarriner committed
    1. Navigate to Announcements Page.
William Warriner's avatar
William Warriner committed
    1. Click `+ Announcements` button.
    1. Enter Topic Title as "Welcome to the Data Science Journal Club course!"
    1. Switch text entry box to raw HTML mode by clicking `</>` symbol at bottom-right of box.
    1. Copy-paste [HTML](welcome_announcement.html) into text entry box.
    1. Switch to WYSIWYG mode: click `</>` symbol again.
    1. Create a "Course Link" to the Syllabus Course Page at the word "Syllabus" in the previous step.
    1. Create a "Course Link" to the Syllabus Affirmation Assignment at the words "Syllabus Affirmation" in the previous step.
- [ ] Upload syllabus to <https://s3.lts.rc.uab.edu/uab-rc-dsjc/syllabus.html>.
wwarriner's avatar
wwarriner committed

## Important Information

### People

| Course Title         | UAB Title                    | Name                 | email              |
| :------------------- | :--------------------------- | :------------------- | :----------------- |
William Warriner's avatar
William Warriner committed
| Instructor of Record | RC Facilitation Manager      | William Warriner     | <wwarr@uab.edu>    |
wwarriner's avatar
wwarriner committed
| Instructor           | RC Facilitator (Scientist I) | Matthew Defenderfer  | <mdefende@uab.edu> |
William Warriner's avatar
William Warriner committed
| Instructor           | RC Facilitator (Scientist I) | Prema Soundararajan  | <prema@uab.edu>    |
wwarriner's avatar
wwarriner committed

### Relevant Pages

- UAB Academic Calendar: <https://www.uab.edu/students/academics/academic-calendar>
- UAB E-Learning Support Canvas Requests: <https://www.uab.edu/elearning/services/canvas-requests>
wwarriner's avatar
wwarriner committed

### Abbreviations

wwarriner's avatar
wwarriner committed
- **DSJC**: Data Science Journal Club
- **GBSC**: Graduate Biomedical Sciences
- **IDNE**: Neuroengineering
wwarriner's avatar
wwarriner committed
- **IOR**: Instructor of Record
wwarriner's avatar
wwarriner committed
- **RC**: Research Computing
wwarriner's avatar
wwarriner committed
- **SLA**: Service Level Agreement
wwarriner's avatar
wwarriner committed
- **TA**: Teaching Assistant
wwarriner's avatar
wwarriner committed
- **WYSIWYG**: What You See Is What You Get
wwarriner's avatar
wwarriner committed
    - Refers to a kind of text editor that lets you see what the resulting document will look like as you make changes.
    - Microsoft Word is WYSIWYG.
    - Most Canvas Page text entry boxes are WYSIWYG by default.
wwarriner's avatar
wwarriner committed

## Notes on Using Canvas

wwarriner's avatar
wwarriner committed
Most Canvas Page text entry boxes, including those of Syllabus and Assignments, have a WYSIWYG HTML editor. The entry mode can be changed to raw HTML mode by clicking the `</>` symbol at the bottom-right of the box. We use raw HTML mode extensively, allowing us to version control invidividual pages for the content of the course.