Important modifications to be applied to Workshop 7

[estebangongora]

Before developing and modifying this workshop, please read through the presenter and developer protocol carefully and refer back to it regularly as you work.

General issues to be addressed

Specific to adapting workshops to a remote framework:

• Fit this workshop to a 3-hour format. The duration of this workshop should be ~3 hours (including exercises and one or two breaks of 5 minutes; excluding longer breaks). To fit this format, please add, edit, or hide slides from existing workshops. You can begin by hiding repetitive examples, non-essential slides, or some of the additional advanced slides that are included at the end of some workshops. Some workshops will be more difficult to shorten than others, due to their subject matter. It is not a problem to let these workshops run slightly over 3 hours to guarantee accurate and complete information. (Use your judgment). DO NOT delete slides. Use the instruction: hidden_remote tag. See an example below:

---
exclude: true

# Slide title: I love statistics!

### Content: Amazing!
---

• Develop new or adapt current exercises to better suit the remote workshop format and the use of breakout rooms. Exercises should be informative and engaging. Remember to leave time for students to work through exercises and ask questions. Refer to these guidelines to find suggestions of exercises promoting active learning. You may use additional resources to create the exercises.

Specific to slide structure, grammar and style

• Ensure code is working correctly and that code matches workshop presentation. Continue to check this as you make changes.

• Proofread correcting spelling, grammar, or punctuation errors (for example, slides 4, 14, 17, 23, 25, 90, and 95).

• Look for and correct the content of slides that overflow the screen.

• Look for and correct prose that mentions function names, object names, package names and code chunks that do not use backticks.

• Look for and correct unnecessary abbreviations (e.g. use do not instead of don’t).

• Correct unnecessary long sentences.

• Ensure that the slides are written in a consistent style, which helps with the flow of workshops and student understanding. This is especially important when working collaboratively with other developers.

• Include presenter notes to the slides you modify. You can write notes for yourself to read in the presenter mode (press the keyboard shortcut p). These notes are written under three question marks ???. See the example below:

---
The content of this workshop is essential for your graduate studies.

???

Note: _The presenter should sing this slide to the participants_.
---

Specific to the translation of this workshop

• Some changes were made to the French version during the last revamping, but not to the English one. Make sure that the changes are also applied to the English version and that the text of the English version is fully translated (for example, slides 22, 48, and 55). See issue 🇫🇷 presentation is slightly ahead #7.

• Add and translate the new modified content to the French version of the workshop.

• Proofread and correct spelling, grammar and punctuation errors.

• Correct unnecessary long sentences.

Specific to this workshop

The workshop on GLMs and GLMMs was often described as being too dense. We have decided to make some changes to improve the flow of workshops 6 and 7:

• We have inverted the order of Workshops 6 and 7.

• The section on GLMMs will be moved (the current) Workshop 7.

• Workshop 6 will now cover GLMs and Workshop 7 will now cover LMMs and GLMMs.

• The GLMM section contained several review slides about LMMs to provide some context for this section of the GLM workshop. The information on said slides (95-98 in the english version) needs to be updated to provide a better flow for this new version the workshop.

• Some of the issues originally addressed to the previous version of Workshop 7 are still relevant for this workshop, given the move of the GLMMs section. Please go over said issues:

  • Issue 1 includes some suggestions for the GLMMs section.
  • Issue 2 refers to the current slide 107 from this workshop.
  • Issue 6 refers to current slide 110 from this workshop.

• Check the feedback from the previous version of this workshop and make the necessary improvements: issue Feedback from previous  #3. (Priority)

• Solve issue REML = FALSE in lmm_f.R #2.

• Solve issue ?isSingular #5.

• Solve issue Warnings #6.

• Wiki links in the README section and in the first slide badges in the presentations go to the GLMs wiki. They should link to: https://wiki.qcbs.ca/r_workshop6 (for the English version) or https://wiki.qcbs.ca/r_atelier6 (for the French version).

• The badges inside the presentation linking to the PDF slides and to the script do not work.

• Make all bullet points follow the same format (e.g. slide 13).

• Make sure that the numbering in and across slides to be consistent (for example, slides 44 and 67).

• Remove repeated text (for example, slide 65).

• Challenge 1 could be further used to engage participants by asking a representative of each group to explain what they discussed before presenting the final solution.

• In the first bullet point of slide 17 (English version) appears to have produced an error when trying to make the text bold (see slide 18 of French version).

• In slide 37 it would be good to have an example of colinearity. Maybe a figure such as this one would be helpful: https://yetanotheriteration.netlify.app/2018/01/high-collinearity-effect-in-regressions/.

• Slide 40 of the English version uses standard deviation in the formula to calculate the z-correction while slide 41 of the French version uses the square root of the variance. While both are equivalent, it would be better to use only one.

• In slide 55 lm() is repeated twice. The second one should be lmer().

• Modify slide 67 so that only "vs" is used (not "VS").

• Slide 89 looks out of place where it is. Maybe moving it after slide 22 would be a better option?

• For the review slides in suggested in slide 98, include the different types of GLMs (families and/or link functions) that will be used for the rest of this workshop. Maybe separating these specific review slides and placing them right before the slide where that type of GLM is mentioned would help the narrative of the workshop and make it easier for participants to understand what will be used immediately after.

• There should be an image in slide 103 which is not showing up because the errDist.png is not in the images folder of this workshop. Migrate the figure from the Workshop 6 image folder.

• A small refresher slide about overdispersion could be useful before slide 104 as this concept was defined in the previous version of the GLM workshop.

• Show the output of the overdisp_fun(mnb1) command in slide 106.

• Fix the formatting of slide 118. Looks like there is a missing ! in ![:cube]().

• A dedicated workshop on LMMs was held at UQAM a couple of years ago (https://wiki.qcbs.ca/lmm.workshop). If possible, material from that workshop could be included into this one. Or at least mention and include the link to the other workshop as a reference in case someone wants to increse their knowledge on this topic (see issue Add material from the dedicated workshop last year that was held at UQAM #4) .

Only close this issue after all cases have been ticked and verified.

[katherinehebert]

• Add a link to this helpful visual explanation of mixed models: http://mfviz.com/hierarchical-models/