Merge branch 'v-fa2023' into 'main'

Prepare for FA2023

Closes #10, #9, #8, #7, and #1

See merge request rc-data-science/communications/dsjc-course!9

data_science_journal_club_checklist.md → checklist.md

@@ -14,10 +14,10 @@ Steps can be performed by any Teachers and Instructors unless otherwise noted.
 - [ ] Add course Teachers and Instructors as needed.
     - Must be done by [IOR](#abbreviations) _after_ merge step is complete! Otherwise, adds may need to be redone.
     - Please visit [Canvas: Add/Remove User(s) SLA page](https://uabprod.service-now.com/service_portal?id=sc_cat_item&sys_id=76f97b59374a670024a67c1643990ece).
-- [ ] Upload [Syllabus HTML](data_science_journal_club_syllabus.html)
+- [ ] Upload [Syllabus HTML](syllabus.html)
     1. Navigate to Syllabus page.
     2. Switch text entry box to raw HTML mode by clicking `</>` symbol at bottom-right of box.
-    3. Copy-paste [HTML](data_science_journal_club_syllabus.html) into text entry box.
+    3. Copy-paste [HTML](syllabus.html) into text entry box.
     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.
@@ -27,15 +27,30 @@ Steps can be performed by any Teachers and Instructors unless otherwise noted.
     8. **Manually verify all links by clicking them!**
     9. Make a note of the Syllabus page URL for use with the Assignments page. _Not_ the Syllabus editing page!
     10. Update syllabus at <https://s3.lts.rc.uab.edu/uab-rc-dsjc/syllabus.html> by manual upload.
-- [ ] Set up the [Assignments HTML](data_science_journal_club_assignment.html)
-    1. Update the Syllabus link in the [Assignment HTML](data_science_journal_club_assignment.html).
-        1. On the first line is an HTML tag that looks like `<a title="Syllabus" href="">`.
-        2. Copy-paste the Syllabus Page URL between the double quotes after `href=`.
-    2. Navigate to Assignments page.
-    3. Click "+ Assignment" button.
-    4. Enter Assignment Name in text entry box: `Demonstration #1`.
-    5. Switch text entry box to raw HTML mode by clicking `</>` symbol at bottom-right of box.
-    6. Copy-paste [HTML](data_science_journal_club_assignment.html) into text entry box.
+- [ ] Set up the [Syllabus Affirmation Assignment HTML](syllabus_affirmation_assignment.html)
+    1. Navigate to Assignments page.
+    2. Click "+ Assignment" button.
+    3. Enter Assignment Name in text entry box: `Syllabus Affirmation`.
+    4. Set the following field values in the remainder of the form.
+        - Points: `1`
+        - Assignment Group: `Assignments`
+        - Display Grade as: `Complete/Incomplete`
+        - Assign:
+            - Assign to: `Everyone`
+            - Due: Monday of 2nd week.
+            - Available from/until: blank
+    5. Click "Build" button.
+    6. Follow instructions at [Syllabus Affirmation Assignment](syllabus_affirmation_assignment.md).
+    7. Click "Done" button.
+- [ ] Set up the [Demonstration Assignment HTML](demonstration_assignment.html)
+    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.
+    5. Copy-paste [HTML](demonstration_assignment.html) into text entry box.
+    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=`.
     7. Switch to WYSIWYG mode: click `</>` symbol again.
     8. Set the following field values in the remainder of the form.
         - Points: `1`
@@ -101,7 +116,7 @@ Steps can be performed by any Teachers and Instructors unless otherwise noted.
     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.
-    5. Copy-paste [HTML](data_science_journal_welcome_announcement.html) into text entry box.
+    5. Copy-paste [HTML](welcome_announcement.html) into text entry box.
     6. Switch to WYSIWYG mode: click `</>` symbol again.
     7. Modify as necessary to be relevant to the current session.
 

data_science_journal_club_syllabus.html → syllabus.html

@@ -99,12 +99,9 @@
 <p>Grading is based purely on demonstrations. Three are required, and each has its own assignment within Canvas.</p>
 <p>The demonstration due dates progress throughout the semester:</p>
 <ul>
-    <li><a title="Demonstration #1" href="">Demonstration #1</a> is due by the 6th
-        Friday.</li>
-    <li><a title="Demonstration #2" href="">Demonstration #2</a> is due by the 10th
-        Friday.</li>
-    <li><a title="Demonstration #3" href="">Demonstration #3</a> is due by the last
-        Friday.</li>
+    <li><a title="Demonstration #1">Demonstration #1</a> is due by the 6th Friday.</li>
+    <li><a title="Demonstration #2">Demonstration #2</a> is due by the 10th Friday.</li>
+    <li><a title="Demonstration #3">Demonstration #3</a> is due by the last Friday.</li>
 </ul>
 <p>Because office hours are open to potentially hundreds of researchers outside the scope of this course, <strong>only
         one session can be presented per student per office hours visit.</strong> <strong><em>Please plan
@@ -153,6 +150,28 @@
 <p>Feel free to seek out and use other sources! If you do so, please inform us of those sources so we can curate our
     list and better serve future students.</p>
 <p>&nbsp;</p>
+<h3>Frequently Asked Questions:</h3>
+<h4>I'm completely new to data science, what are some good starting points?</h4>
+<ul>
+    <li>To get started with general data science tools and techniques, try Kaggle Learn: <a
+            href="https://www.kaggle.com/learn" target="_blank" rel="noopener">https://www.kaggle.com/learn</a><a
+            href="https://rosalind.info/problems/locations/" target="_blank" rel="noopener"></a></li>
+    <li>Check out the Data Carpentries Lessons: <a href="https://datacarpentry.org/lessons/" target="_blank"
+            rel="noopener">https://datacarpentry.org/lessons/</a></li>
+    <li><a href="https://www.kaggle.com/learn" target="_blank" rel="noopener"></a>For starting bioinformatics, also try
+        Rosalind.info: <a href="https://rosalind.info/problems/locations/" target="_blank"
+            rel="noopener">https://rosalind.info/problems/locations/</a></li>
+</ul>
+<h4>What tools are available to make it easier to manage my projects?</h4>
+<ul>
+    <li>We suggest using Git! Learn more at: <a href="https://swcarpentry.github.io/git-novice/" target="_blank"
+            rel="noopener">https://swcarpentry.github.io/git-novice/</a></li>
+</ul>
+<h4>Am I allowed to use my own research projects for this course?</h4>
+<ul>
+    <li>Yes, and we encourage applying new tools and techniques! Be mindful that we can't accept any work for research
+        protected by IRB or using PHI/HIPAA data. Be sure to get your supervisor's approval first.</li>
+</ul>
 <h3 id="support">Technical Support:</h3>
 <p>Research Computing Official Site: <a class="external" href="https://www.uab.edu/it/home/research-computing"
         target="_blank" rel="noopener">https://www.uab.edu/it/home/research-computing</a>.</p>

syllabus_affirmation_assignment.md

+# Title
+
+## Instructions
+
+- Use the following text:
+
+    > In a new window, please read the Syllabus, then return here to complete the affirmation.
+
+- On the word "Syllabus", insert a link to the syllabus page.
+
+## Questions
+
+Use the following pattern for each question.
+
+- Use the following question title:
+
+    > When is the first/second/third Demonstration due?
+
+- Use the following question stem:
+
+    > The date is...
+
+- Answers, in any order
+    1. The correct date. Click the radio button for this answer!
+    2. A random date during the semester
+    3. Another random date during the semester
+    4. One more random date during the semester
+- Options: check "shuffle choices"