Skip to content
Snippets Groups Projects
checklist.md 8.92 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
Steps can be performed by any Teachers and Instructors unless otherwise noted.
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
- [ ] Upload [Syllabus HTML](syllabus.html)
wwarriner's avatar
wwarriner committed
    1. Navigate to Syllabus page.
    2. Switch text entry box to raw HTML mode by clicking `</>` symbol at bottom-right of box.
wwarriner's avatar
wwarriner committed
    3. Copy-paste [HTML](syllabus.html) into text entry box.
wwarriner's avatar
wwarriner committed
    4. Update Demonstration assignment links.
        1. Look for the three HTML tags like `<a title="Demonstration #1" href="">`.
        2. For each one, add the appropriate assignment page path, which should look like `/courses/$course_number/assignments/$assignment_number`, e.g. like `/courses/1601187/assignments/6860919`. This can be found by visiting the assignment to get the `$course_number` and `$assignment_number` values.
    5. Switch to WYSIWYG mode: click `</>` symbol again.
    6. Check "Show Course Summary" checkbox.
    7. Verify formatting is correct.
    8. Make a note of the Syllabus page URL for use with the Assignments page. _Not_ the Syllabus editing page!
    9. Update syllabus at <https://s3.lts.rc.uab.edu/uab-rc-dsjc/syllabus.html> by manual upload.
- [ ] Set up the Syllabus Affirmation Assignment
    1. Navigate to Quizzes page.
    2. Click "+ Quiz" button.
    3. Select "Classic Quizzes".
    4. Click "Submit" button.
    5. Enter in first text entry box: `Syllabus Affirmation`.
    6. Enter in the "Quiz Instructions" text entry box:
        > "In a new window, please read the Syllabus, then return here to complete the affirmation."
    7. Create a link to the Syllabus Course Page at the word "Syllabus" in the previous step.
    8. 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
        - Assign:
            - Assign to: `Everyone`
            - Due: Wednesday of 2nd week.
wwarriner's avatar
wwarriner committed
            - Available from/until: blank
    9. Click "Questions" tab.
    10. Click "+ New Question".
        - 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".
    11. Click "Details" tab.
    12. 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.
    2. Click "+ Assignment" button.
    3. Enter Assignment Name in text entry box: `Demonstration #1`.
    4. Switch text entry box to raw HTML mode by clicking `</>` symbol at bottom-right of box.
wwarriner's avatar
wwarriner committed
    5. Copy-paste [HTML](demonstration_assignment.html) into text entry box.
wwarriner's avatar
wwarriner committed
    6. Update Syllabus link.
        1. On the first line is HTML tag that looks like `<a title="Syllabus" href="">`.
        2. Copy-paste Syllabus Page URL between double quotes after `href=`.
wwarriner's avatar
wwarriner committed
    7. Switch to WYSIWYG mode: click `</>` symbol again.
    8. Set the following field values in the remainder of the form.
        - 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.

                | 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
    9. Click save and publish!
wwarriner's avatar
wwarriner committed
    10. For `Demonstration #2` and `Demonstration #3`:
wwarriner's avatar
wwarriner committed
        1. Go to the main Assignments page.
        2. Click the vertical three dots next to the `Demonstration #1` assignment you created.
wwarriner's avatar
wwarriner committed
        3. Click "Duplicate".
        4. On the new entry, click the vertical three dots, then "Edit Assignment".
        5. Modify the "Name" field appropriately.
        6. Click "Save & Publish".
wwarriner's avatar
wwarriner committed
    11. Verify the assignments are published in the Assignments main page, with a green checkmark icon next to each.
wwarriner's avatar
wwarriner committed
- [ ] Set up Home page.
    1. Navigate to Home page.
    2. Click "Choose Home Page" button.
    3. Select "Syllabus".
    4. Click "Save" button.
- [ ] 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
wwarriner's avatar
wwarriner committed
        - Put them in the above order!
- [ ] Verify links using "Course Link Validator" on Settings page.
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).
wwarriner's avatar
wwarriner committed
- [ ] Publish the course. May need to 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.
    2. Click `+ Announcements` button.
    3. Enter Topic Title as "Welcome to the Data Science Journal Club course!"
    4. Switch text entry box to raw HTML mode by clicking `</>` symbol at bottom-right of box.
wwarriner's avatar
wwarriner committed
    5. Copy-paste [HTML](welcome_announcement.html) into text entry box.
wwarriner's avatar
wwarriner committed
    6. Switch to WYSIWYG mode: click `</>` symbol again.
    7. Modify as necessary to be relevant to the current session.
wwarriner's avatar
wwarriner committed

## Important Information

### People

| Course Title         | UAB Title                    | Name                 | email              |
| :------------------- | :--------------------------- | :------------------- | :----------------- |
| Instructor of Record | Associate Professor          | Kristina M. Visscher | <kmv@uab.edu>      |
| Instructor           | RC Facilitator (Scientist I) | William Warriner     | <wwarr@uab.edu>    |
| Instructor           | RC Facilitator (Scientist I) | Matthew Defenderfer  | <mdefende@uab.edu> |

### Relevant Pages

- UAB Academic Calendar: <https://www.uab.edu/students/academics/academic-calendar>

### 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.