Important modifications to be applied to Workshop 6

[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!
---

Specific to slide structure, grammar and style

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

• 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 71, 86, and 89).

• Look for and correct the content of slides that overflow the screen (for example, slides 45, 46, 65, 83, and 88).

• 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) or NB instead of negative binomial (see slide 87).

• 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

• 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

This workshop is often described as being too dense. We have decided to make some changes to improve the flow of this workshop:

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

• Some of the issues (i.e. issues Random effect (1 | X) #2 and Incorrect plot titles #6) no longer pertain to this workshop due to the movement of the GLMM section. Please leave these issues open so that the developers of Workshop 6 can address them

• This workshop also has some problems with it's structure as it does not follow a linear narrative (see issue Pedagogical and structural issues #3). Here are some examples on how the narrative could be improved (Top Priority):

  • The first mention of how a GLM differs from a LM and the main components of a GLM appear in slides 39-41. However, previous slides have already described some types of distributions without having mentioned how they fall within a GLM. Moving slides 39-41 after slide 24 will help the narrative of this workshop.
  • The presentation doesn't describe well what families and link functions are or how they are included in the R model. It also doesn't clearly show what the family and link function is for each variant of a GLM. Including this information on each section will help participants understand better. Maybe a table like this one will be useful to accomplish this.
  • As mentioned before, slides 25-30 describe the different types of distributions that can be applied in a GLM but they don't actually relate back to a specific regression. These slides should be moved further into the presentation into their respective regressions.

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

• Solve issue Code chunks are cut off or split the text #5.

• Slide 8: circle the plots that suggest a statistical relationship.

• Slide 42: Explain the association of mu and p (i.e. for logit, mu = p).

• Slide 49: the part about the identity link could be eliminated (or moved after slide 51) to avoid confusion.

• Slides 49-51: lots of presenters notes can be helpful here as this is a complex concept.

• Slide 52: move the last sentence and chunk into a separate slide and also include the chunk from the wiki about how to interpret odds that are larger than 1 vs odds that are smaller than 1.

• Slides 54 and 55: There is some repeated text in these slides than can be removed. Also, θs is repeated inside the same sentence.

• Slide 58: the description of the Hosmer-Lemenshow test can be moved to a new slide between slides 59 and 60. This new slide can also be used to explain that this test is an alternative for the diagnostic plots which are not useful for logistic regressions (check the wiki for further explanation).

• Slide 80: the sentence "Since the Poisson..." is not clear and could use some rephrasing.

• Slide 81: replace "phi" by the greek letter (ϕ).

• Slide 85: a sentence explaining how to select among the distributions based on the dispersion parameter could help to make the diagram clearer.

• Slide 86: the sentence that starts with "k controls..." should be its own bullet point.

• Slide 88: move the text "theta=k" higher up so that it doesn't cover the R output.

• Slide 89: it should be confidence interval, not confidence envelope.

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