Workshop Consolidation: Bruce

jackVanish commented 3 years ago

For each of the following lessons in the workshops, ascertain the following.

Do we want to continue to teach this material, or is it outdated and of no further use? If we want to teach it, where in the curriculum does it fall? (A ballpark is fine, we’re going to have to change the exact numbering once we have all the lessons assembled, so just provide a rough location.
Is the material already covered by a lesson in the ACT workshop? If so, determine whether or not the lessons are worth merging together, or if the redundant lesson should be discarded. If they need merging, merge them.
If the lesson contains code, determine what data we want to run the code on, and ensure that it works. Does the code need to be updated to use different data from the ACT workshop? If we need to add more files to the data folder for the ACT workshop, find and include suitable data.

Record any observations or thoughts that you have in the comments of this ticket so that we have a unified paper trail for each person. When your review of a particular lesson is done, and that lesson is deleted or merged, in whole or part, into the main workshop code, tick the box next to it.

Master workshop repo: https://github.com/ocean-tracking-network/2021-04-13-act-workshop

[x] "Intro to R"
[x] "Intro to Dataframes"
[x] "Intro to Plotting"
[x] "Intro to GLATOS"
[x] "More features of GLATOS"
[x] "Basic visualizations"

OTNSPG R July 16, 2020 https://github.com/ocean-tracking-network/2020-07-16-OTNSPG-R-workshop

[x] "Base R functions vs Tidyverse"
[x] "ggplot basics"
[x] "Spatial objects"
[x] "Interactive exploration of data"

Combined Acoustic Telemetry Tool Training: https://ocean-tracking-network.github.io/jb-acoustic-telemetry/index.html

[x] "Data Manipulation Basics"
[x] "Summarising and plotting data"
[x] "Advanced Plotting"
[x] "Animating Animal Movement"
[x] "Working with Spatial Data"

There are also a couple of things that I think everyone should have a look at, just for the sake of deciding what direction it'll go in.

Master Workshop Repo: https://github.com/ocean-tracking-network/2021-04-13-act-workshop

[x] "Other curriculums" Now would be a good time to just spool through this quickly and make sure it's accurate and up to date, and that there's not anything else we want to add. It looks fine from what I've seen, but as long as we're in workshop brain mode, we might as well make sure.

Combined Acoustic Telemetry Tool Training: https://ocean-tracking-network.github.io/jb-acoustic-telemetry/index.html

[x] "Introduction to Acoustic Telemetry Data Analysis" We should take a look at this and ensure that it's consistent and relevant, if we intend to keep it. I'm not sure who gets to pull the trigger on this one, though.

jackVanish commented 3 years ago

The three intro lessons need to be beefed up with more text if we want to make this our base curriculum going forward. That's just a note for myself.

jackVanish commented 3 years ago

Just to update myself, it looks like I went back and beefed up the text for those 3 lessons.

jackVanish commented 2 years ago

Text update is done for 8 but I'm not checking it off because it still needs to have its code split up for use across FACT/ACT/GLATOS

jackVanish commented 2 years ago

I've had a look at the R versus Tidyverse lesson in the OTNSPRG workshop (https://github.com/ocean-tracking-network/2020-07-16-OTNSPG-R-workshop/blob/gh-pages/_episodes/01-r-telemetry-base-r-and-tidyverse.md) and I don't think we need to do any extra work to port it. The base R section is a stripped-down version of the Intro To R episode that we're already teaching, and the Tidyverse section is revamped and covered in more detail in the R Dataframes lesson. Put it in the bin!!!

jackVanish commented 2 years ago

I've had a look at https://github.com/ocean-tracking-network/2020-07-16-OTNSPG-R-workshop/blob/gh-pages/_episodes/02-r-telemetry-ggplot-basics.md, the ggplot basics lesson, and after some deliberation I don't think we need to port it forward to OTW. All the basics of ggplot2 are covered more comprehensively in our current R plotting lesson, and what's in the old lesson is a little bit dense for beginners- lots of lines of code thrown at learners without good guidelines for instructors on how to break it down. We could run it forward into OTW with a more comprehensive breakdown, but past a certain point we'd just be explaining every possible option to aes() and that's not what we want to do, especially in a format where we're historically pressed for time. I'm not against adding some specific things to augment our current lesson (labs() for axis labelling seems like it'd pre-empt a lot of questions that we get) but in the main I think we can leave this. Would appreciate opinions on this, though.

jackVanish commented 2 years ago

Short discussion with Jon et al confirms that we do not need the spatial objects lesson from OTNSPG: https://github.com/ocean-tracking-network/2020-07-16-OTNSPG-R-workshop/blob/gh-pages/_episodes/03-r-telemetry-spatial-objects.md

jackVanish commented 2 years ago

We'd in general like to keep the interactivity/animation exploration lesson but not the current way we're doing it here https://github.com/ocean-tracking-network/2020-07-16-OTNSPG-R-workshop/blob/gh-pages/_episodes/06-r-telemetry-animating-ggplot.md. New ticket opened to address this, knocking it off the list.

jackVanish commented 2 years ago

Brownscombe "Advanced Plotting" lesson is more animation and the like. I folded that into the ticket for creating an updated animation lesson.

jackVanish commented 2 years ago

Same goes for the "Animating animal movements" lesson in Brownscombe.

jackVanish commented 2 years ago

I'm ticking off the "Other Curriculums" box because there's been an extended conversation in Slack about it, to whit, whether or not it needs to be kept at all. I'm of the opinion that it's not useful or worthwhile to link students out to lessons we've decided are deprecated and that we don't want to teach anymore, but that's not unanimous and there's a strong case for maintaining it internally as a master-list as well. In the end the agreement reached was that we would reconcile other OTW tickets first and then circle back on this one once we have an idea of whether or not there's anything of worth left in past curricula. So I'm going to tick it off here and open a new ticket to mark that a broader discussion needs to be had.

CaitlinBate commented 2 years ago

I've had a look at https://github.com/ocean-tracking-network/2020-07-16-OTNSPG-R-workshop/blob/gh-pages/_episodes/02-r-telemetry-ggplot-basics.md, the ggplot basics lesson, and after some deliberation I don't think we need to port it forward to OTW. All the basics of ggplot2 are covered more comprehensively in our current R plotting lesson, and what's in the old lesson is a little bit dense for beginners- lots of lines of code thrown at learners without good guidelines for instructors on how to break it down. We could run it forward into OTW with a more comprehensive breakdown, but past a certain point we'd just be explaining every possible option to aes() and that's not what we want to do, especially in a format where we're historically pressed for time. I'm not against adding some specific things to augment our current lesson (labs() for axis labelling seems like it'd pre-empt a lot of questions that we get) but in the main I think we can leave this. Would appreciate opinions on this, though.

agree: this dataset is not OTN-format (its Rob lennox's custom dataset) and ive OTN-ified all the plots i wanted out of here and into the OTW "reports for taggers" lesson already anyway (the best place for it)

checking off the list as "done"

jackVanish commented 2 years ago

Brownscombe spatial data lessons are gonna be spun off and reworked into a new lesson altogether, tracking through this ticket here: https://github.com/ocean-tracking-network/otn-workshop-base/issues/26

jackVanish commented 2 years ago

Chatted with Jon about the Brownscombe intro lesson (https://ocean-tracking-network.github.io/jb-acoustic-telemetry/01-introduction-to-analysis/index.html) and we decided that we do want an equivalent in the OTW- a generic workshop intro that introduces OTN as well as all the packages we're going to use- but not the JB one. Rather, Caitlin's intro from the February 2022 MigraMar lesson (https://ocean-tracking-network.github.io/migramar-student-workshop-2022/) will form the base, and we'll add package-specific intros to that. I'll open a new ticket to manage that.

ocean-tracking-network / otn-workshop-base

Workshop Consolidation: Bruce #2