diff --git a/_make_pdf.qmd b/_make_pdf.qmd index 365dfcd..7e58df8 100644 --- a/_make_pdf.qmd +++ b/_make_pdf.qmd @@ -7,7 +7,7 @@ citation_url: https://openscapes.github.io/series format: pdf: toc: true - toc-depth: 2 + toc-depth: 3 number-sections: true number-depth: 1 output-file: "openscapes-series" @@ -61,17 +61,19 @@ process_qmd <- function(file, fpath_in = "images/", fpath_out = "images/", level parts <- list( list(title = "Welcome", dir = ".", file = "index.qmd", img_path = "images/", level = 1), + list(title = "Program Summary", dir = ".", file = "program-summary.qmd", img_path = "images/", level = 1), + list(title = "What to Expect", dir = ".", file = "what-to-expect.qmd", img_path = "images/", level = 1), + list(title = "Pathways & Outcomes", dir = ".", file = "pathways.qmd", img_path = "images/", level = 1), list(title = "Core Lessons", dir = "core-lessons", file = "index.qmd", img_path = "images/", level = 1), list(title = "Mindset", dir = "core-lessons", file = "mindset.qmd", img_path = "images/", level = 2), list(title = "Better Science", dir = "core-lessons", file = "better-science.qmd", img_path = "images/", level = 2), - list(title = "GitHub Strategies", dir = "core-lessons/github", file = "index.qmd", img_path = "images/", level = 2), - list(title = "GitHub for publishing", dir = "core-lessons/github/", file = "github-pub.qmd", img_path = "images/", level = 3), - list(title = "GitHub for project management", dir = "core-lessons/github/", file = "github-issues.qmd", img_path = "images/", level = 3), list(title = "Team Culture", dir = "core-lessons", file = "team-culture.qmd", img_path = "images/", level = 2), list(title = "Data Strategies", dir = "core-lessons", file = "data-strategies.qmd", img_path = "images/", level = 2), list(title = "Coding Strategies", dir = "core-lessons", file = "coding-strategies.qmd", img_path = "images/", level = 2), list(title = "Open Communities", dir = "core-lessons", file = "communities.qmd", img_path = "images/", level = 2), - list(title = "Pathways", dir = "core-lessons", file = "pathways.qmd", img_path = "images/", level = 2), + list(title = "GitHub Strategies", dir = "core-lessons/github", file = "index.qmd", img_path = "images/", level = 2), + list(title = "GitHub for publishing", dir = "core-lessons/github/", file = "github-pub.qmd", img_path = "images/", level = 3), + list(title = "GitHub for project management", dir = "core-lessons/github/", file = "github-issues.qmd", img_path = "images/", level = 3), "# Additional Lessons", list(title = "Code of Conduct", dir = "additional-lessons", file = "code-of-conduct.qmd", img_path = "images/", level = 2), list(title = "Reporting & SciComm", dir = "additional-lessons", file = "reporting-scicomm.qmd", img_path = "images/", level = 2), diff --git a/_quarto.yml b/_quarto.yml index 2867912..6f1477a 100644 --- a/_quarto.yml +++ b/_quarto.yml @@ -39,6 +39,12 @@ website: contents: - href: "index.qmd" text: Welcome + - href: "program-summary.qmd" + text: Program Summary + - href: "what-to-expect.qmd" + text: What to Expect + - href: "core-lessons/pathways.qmd" + text: Pathways & Outcomes - section: core-lessons/index.qmd contents: - href: "core-lessons/mindset.qmd" @@ -57,8 +63,6 @@ website: text: Coding strategies - href: "core-lessons/communities.qmd" text: Open communities - - href: "core-lessons/pathways.qmd" - text: Pathways - section: "Additional Lessons" contents: - href: "additional-lessons/code-of-conduct.qmd" @@ -88,7 +92,6 @@ website: contents: - href: "inspiration/resources-that-influence.qmd" text: Resources that influence us - format: html: diff --git a/additional-lessons/code-of-conduct.qmd b/additional-lessons/code-of-conduct.qmd index 3166ff2..306e7ff 100644 --- a/additional-lessons/code-of-conduct.qmd +++ b/additional-lessons/code-of-conduct.qmd @@ -1,7 +1,5 @@ --- title: Code of Conduct -aliases: - - ../additional-lessons/code-of-conduct.html --- Please see [Openscapes' Code of Conduct](https://openscapes.org/code-of-conduct) and [slides](https://docs.google.com/presentation/d/11816HbwRCvnr8dFXkk8UqfSy_0O4svEoFFFyHOZ0IBE/) (June 2021) that accompany this lesson. diff --git a/core-lessons/better-science.qmd b/core-lessons/better-science.qmd index 5e573b4..95e66e3 100644 --- a/core-lessons/better-science.qmd +++ b/core-lessons/better-science.qmd @@ -1,11 +1,11 @@ --- -title: "Better science in less time" +title: "Better science for future us" aliases: - bsilt.html - ../better-science.html --- -Better science is less time is science that is more efficient, reproducible, open, inclusive, and kind. There are growing examples of better science in less time in environmental and Earth science, and beyond, including from the Ocean Health Index team: [Our path to better science in less time using open data science tools](https://www.nature.com/articles/s41559-017-0160) (Lowndes et al. 2017). +"Better science for future us" is science that is more efficient, reproducible, open, inclusive, and kind. There are growing examples of better science in environmental and Earth science, and beyond, including from the Ocean Health Index team: [Our path to better science in less time using open data science tools](https://www.nature.com/articles/s41559-017-0160) (Lowndes et al. 2017). ::: {.callout-warning icon="false"} ## Slides @@ -41,15 +41,18 @@ Here we also introduce the [**Pathways concept**](/core-lessons/pathways.qmd) th ### Create space -The OHI team created space for synchronous collaboration: convenings to learn and teach each other together. +Creating space means committing to synchronous collaboration convenings to learn and teach each other together. -A critical first part of this was prioritizing time (which included getting buy-in, lobbying, showcasing). Then, this meant that the team could focus time on: +A critical first part of this was prioritizing time (which included getting buy-in, showcasing). Then, this meant that the team could focus time on: - Getting comfortable talking about data/workflows - Building trust (to share imperfect work) - Recognizing that what we invest incrementally will have large dividends in the future -The OHI team started having "Seaside Chats": 1x/week where they discussed filenaming, code review, standard operating procedures and documentation, and much more. +::: {.callout-note icon="false"} +# How we did it: OHI Team +The OHI team started having regular Seaside Chats 1x/week where they discussed filenaming, code review, standard operating procedures and documentation, and much more. We prioritized regular social hours, that we scheduled during work hours so that everyone could participate no matter their other outside-of-work responsibilities. +::: ### Create place @@ -61,44 +64,49 @@ Asynchronous collaboration often requires some form of version control so the te Through creating space and place, teams will find the common workflows, tools, skills that they already have and need to do their work. -For the OHI team, we asked how to make sure everyone can participate as they need to? We introduced new software sparingly, and helped each other learn. This included initial setup as well as follow up and practice. We leveraged existing habits & resources - within and beyond our team. [Open communities](communities.qmd) were a big part of this learning. Through this we were able to distinguish data preparation (tidying) as distinct from our science, and make this actionable by shifting to smaller modular code to combine for different reports/audiences. - **Documentation was a key part of this**. And, writing documentation "for nobody" is very hard, and it's a huge task. We prioritized documentation based on Onboarding and Offboarding: for our future selves first, and then future us. -### What was it really like? Transition to GitHub - -Changing behavior/habits takes time, and is messy. Here is part of the story: +::: {.callout-note icon="false"} +# How we did it: OHI Team +The OHI team asked, "how can we make sure everyone can participate as they need to?" Not everyone on the team needed to learn to code, or to use GitHub in the same way. We introduced new software sparingly, and helped each other learn. This included initial setup as well as follow up and practice. We leveraged existing habits & resources - within and beyond our team. [Open communities](communities.qmd) were a big part of this learning. Through this we were able to distinguish data preparation (tidying) as distinct from our science, and make this actionable by shifting to smaller modular code to combine for different reports/audiences. +::: -![Ocean Health Index (OHI) team's transition of code and shifting communication to GitHub](images/ohi-transition-github.png){fig-align="center" width="80%"} +### Shifting incrementally -## Ocean Health Index: behind the scenes +Shifting workflows takes time, particularly because it is most often done while also meeting existing deliverables and deadlines. It requires changing behaviors and habits, which takes time, and is messy, and really depends on the trust built with the team. -Some key points to discuss from [Our path to better science in less time using open data science tools](https://www.nature.com/articles/s41559-017-0160) (Lowndes et al. 2017): +::: {.callout-note icon="false"} +# How we did it: OHI Team -- Reproducibility & communication enabled by open tooling -- Shared practices are useful beyond shared projects +The OHI shift to using shared Google Docs, R and GitHub was motivated by necessity, reimagined by possibility and community, and done incrementally. It was an investment over years, but the enduring payoff has been huge. -If you're interested in more overview of the OHI setup, see this 2017 talk (25 mins): [OHI Better science in less time](https://www.youtube.com/watch?v=x4uzVAZvFCA) or this 2021 Plenary at [Better Science for Future Us](https://docs.google.com/presentation/d/1HGw4P095-lblHiGQHXYidHiVysjrPxuojxTxKtE13vk/edit) at the inaugural Society for Open, Reliable, and Transparent Ecology and Evolutionary Biology [SORTEE conference](https://www.sortee.org/events/) (30 minutes) ([video](https://osf.io/47req)). +Some key points to discuss from [Our path to better science in less time using open data science tools](https://www.nature.com/articles/s41559-017-0160) (Lowndes et al. 2017): reproducibility & communication enabled by open tooling; and shared practices are useful beyond shared projects. -### OHI pathway +![Ocean Health Index (OHI) team's transition of code and shifting communication to GitHub](images/ohi-transition-github.png){fig-align="center" width="80%"} -- Motivated by necessity -- Reimagined by possibility and community -- Done incrementally! -- Yes: it's an investment. -- Also yes: huge, enduring payoff for (your) science +If you're interested in more overview of the OHI setup, see this 2017 talk (25 mins): [OHI Better science in less time](https://www.youtube.com/watch?v=x4uzVAZvFCA) or this 2021 Plenary at [Better Science for Future Us](https://docs.google.com/presentation/d/1HGw4P095-lblHiGQHXYidHiVysjrPxuojxTxKtE13vk/edit) at the inaugural Society for Open, Reliable, and Transparent Ecology and Evolutionary Biology [SORTEE conference](https://www.sortee.org/events/) (30 minutes) ([video](https://osf.io/47req)). +::: ### Reproducibility & communication enabled by open tooling RMarkdown/Quarto to reimagine data analysis and communication. RMarkdown/Quarto combines analyses & figures together, rendered to your reporting output of choice. -An example: +::: {.callout-note icon="false"} +# How we did it: OHI Team + +An example: -- Website built with R/RMarkdown & Github\ +- Website built with R/RMarkdown & Github - You can get started too: [1-hour RMarkdown tutorial](https://jules32.github.io/rmarkdown-website-tutorial/); [Quarto website tutorial](https://openscapes.github.io/quarto-website-tutorial/) +::: ### Shared workflows not only useful for shared projects +It's about increasing efficiency and reproducibility and open science. But it is also about increasing participation and inclusion. Consider how inclusion and equity show up in your daily practices. How you work and onboard others to your projects is a DEIA issue. + +::: {.callout-note icon="false"} +# How we did it: OHI Team + - OHI team: we identified as a team & prioritized helping each other - We work on many different projects - Use same workflows, share feedback, can think together across projects @@ -106,16 +114,11 @@ An example: - Common ground, easier to talk about, easier to ask for help - You don't need to design everything from scratch -And, critically: +::: -- It's about increasing efficiency and reproducibility and open science. -- But it is also about increasing participation and inclusion. -- Consider diversity, equity, and inclusion in your daily practices. -- How you work and onboard others to your projects is a DEI issue. +## Impact of shifting to open science -## Examples: environmental science - -Here are a few examples to showcase what is possible and being done by the community. +Here are a few examples to showcase what is possible and being done in environmental science. - [Regime Shifts in R & Data Science within the BC Public Service Observations from the field](https://stephhazlitt.github.io/regime-shifts/slides#1) - Stephanie Hazlitt, Government of British Columbia, slides from CascadiaRconf keynote - [NMFSReports: Easily write NOAA reports and tech memos in R Markdown](https://github.com/EmilyMarkowitz-NOAA/NMFSReports/blob/main/presentations/2021-06-05NMFSReports-RCascadiaConf.pdf)! - Emily Markowitz, NOAA Alaska Fisheries Science Center, slides from CascadiaRconf talk @@ -124,6 +127,20 @@ Here are a few examples to showcase what is possible and being done by the commu - [TBEP's Data Management Workflow](https://tbep-tech.github.io/data-management-sop/workflow.html) and open science cake - [Coordinated monitoring of the Piney Point wastewater discharge into Tampa Bay: Data synthesis and reporting](https://www.researchgate.net/publication/373388123_Coordinated_monitoring_of_the_Piney_Point_wastewater_discharge_into_Tampa_Bay_Data_synthesis_and_reporting), 2023. Florida Scientist, 86(2), pp.288-300 - Beck, M.W., Burke, M.C., Raulerson, G.E., Scolaro, S., Sherwood, E.T. and Whalen, J. +::: {.callout-note icon="false"} +# How we did it: OHI Team + +Ocean Health Index has produced annual reports for 12 years (2012-2024) and counting! There are many impacts of this, but at a glance: + +- In 2012, it took 30 people 4 years and several $M to complete the 1st annual OHI report. +It would not continued if it costed so much time and $ each time. +- In 2024, it takes 3 masters students in 3 months and $200K. + +This is possible because of the incremental investment to make it reproducible, efficient, documented - focus on onboarding. Impacts mean that students and team can focus on new questions, making sense of results, and applications from this, not the assessment itself. +And, it accelerates the rate at which other teams can get to this cost savings, since OHI is an example that it’s possible, a working open example. +::: + + ## Further resources ### Not so standard deviation podcast diff --git a/core-lessons/coding-strategies.qmd b/core-lessons/coding-strategies.qmd index d1cb5ff..1bc8dc3 100644 --- a/core-lessons/coding-strategies.qmd +++ b/core-lessons/coding-strategies.qmd @@ -63,9 +63,12 @@ project (“product”). - Name of your home directory. - R code you ran before lunch. -**Clearly product:** - Raw data. - R code someone needs to run on your +**Clearly product:** + +- Raw data. +- R code someone needs to run on your raw data to get your results, including the explicit library() calls to -load necessary packages. (script, notebook) +load necessary packages. (script, notebook). **Ideally, you don’t hardwire anything about your workflow into your product.** diff --git a/core-lessons/communities.qmd b/core-lessons/communities.qmd index c7984f3..4fd1287 100644 --- a/core-lessons/communities.qmd +++ b/core-lessons/communities.qmd @@ -20,7 +20,7 @@ Open communities play a big role in advancing research, helping research feel le ------------------------------------------------------------------------ -In your work, you're not limited to the people & resources in your physical environment! Open communities are waiting for people like you to come participate in whatever way feels comfortable right now. Awesome people are developing and sharing code and learning resources. They connect through open communities and software (GitHub, forums, Mastodon, Bluesky, TikTok, Slack) +In your work, you're not limited to the people & resources in your physical environment! Open communities are waiting for people like you to come participate in whatever way feels comfortable right now. Awesome people are developing and sharing code and learning resources. They connect through open communities and software (GitHub, forums, Mastodon, Bluesky, Slack) We can all learn, reuse, remix, share, and contribute and this means less reinventing, more doing, more fun! diff --git a/core-lessons/github/github-issues.qmd b/core-lessons/github/github-issues.qmd index 6729748..5451b61 100644 --- a/core-lessons/github/github-issues.qmd +++ b/core-lessons/github/github-issues.qmd @@ -43,7 +43,7 @@ While there are many options for project management software out there, we use and teach GitHub because it's already managing our code and our work, and linked to our collaborators so it offers a streamlined way to communicate. (It's also one less account to manage, which is a huge -bonus in Julie Lowndes' mind). +bonus!). One of the reason we talk about Issues in Openscapes is because they are an excellent way to develop habits for using GitHub for your analytical @@ -121,7 +121,7 @@ sometimes Issues are public and sometimes they are private. - In a private repo, only users with permission can create and comment on issues, or see them at all -GitHub search is awesome – it will search all of your files and Issues! +Remeber GitHub's search is awesome – it will search all of your files and also Issues! ## Issues in the Wild @@ -130,7 +130,7 @@ Here are some examples of "traditional" and "non-traditional" use of issues. [ggplot2's Issues](https://github.com/tidyverse/ggplot2/issues) is an -example of what I think is the "traditional" use of Issues, which is in +example of the "traditional" use of Issues, which is in a pretty pure software development context. This is a public repository, and all topics are directly related to ggplot2. Issues are largely used to report bugs, troubleshoot and sometimes to request features. Note the @@ -336,9 +336,7 @@ fact, you can have multiple projects within the same repository, so different people can have different Projects organized within their shared repository, for example. -You have a lot of control over how you will manage your Projects; at -this point I do not use all the features but have been playing around -with using them for Openscapes planning: +You have a lot of control over how you will manage your Projects. Here is one view:
@@ -378,7 +376,8 @@ repository's Settings) will make not only the code and files of that repo public, but also all the Issues. Which is fine, but it might add considerations in terms of what is discussed in those Issues. -### Ocean Health Index example +::: {.callout-note icon="false"} +# How we did it: OHI Team Here is an example of the Ocean Health Index team’s thought process & strategy. @@ -399,6 +398,7 @@ These two needs led us to create a single private repository named especially since our team-lead can engage in these discussions by receiving emails about the Issues in their inbox, and can respond without having to go to GitHub.com. +::: ## Your Turn: Create & comment on issues @@ -407,7 +407,7 @@ Issues. Here is what to do: - Go to [github.com/openscapes/demo/issues](https://github.com/openscapes/demo/issues) -- Create an issue, tag people in your breakout group (ask for their +- Create an issue, tag colleagues (ask for their username) - Browse issues, comment in other issues - Try: @@ -416,14 +416,14 @@ Issues. Here is what to do: - Adding Issues to a Project (create one if need be) - Closing an Issue -Have fun! And throughout the process, talk to your breakout group, and +Have fun! And throughout the process, talk to your colleagues, and share what you learn. Here's what your inbox will look like afterwards:
-![](images/issues-inbox-crop.png){fig-align="center" width="80%"} +![](images/issues-inbox-crop.png){fig-align="center" width="70%"}
diff --git a/core-lessons/github/github-pub.qmd b/core-lessons/github/github-pub.qmd index 1035483..a0c7873 100644 --- a/core-lessons/github/github-pub.qmd +++ b/core-lessons/github/github-pub.qmd @@ -4,20 +4,6 @@ aliases: - /github-pub.html --- -```{=html} - -``` GitHub is known as a place to store code, but it's also a powerful publishing system. It is a way to help you share about your project on the open web, which lets you share about your science earlier. ## Preamble @@ -28,10 +14,6 @@ For this GitHub Clinic, we are going to work with GitHub from the browser only, GitHub can reduce friction for open science: it gives us avenues for communicating and publishing methods, blogs, interactive graphics and more, without a lot of heavy lifting! -### Prerequisite - -You will need to create **GitHub** account at , if you don't already have one. Optional advice from Jenny Bryan about [choosing a username](https://happygitwithr.com/github-acct). - ## What is GitHub? — Traditional answer GitHub means GitHub.com; it’s a company that is an online collaborative platform, with some features familiar to social media users. @@ -48,11 +30,11 @@ It is used for code and files: organize, archive, bookkeeping, searchable, chang ### Disclaimer -We aren’t going to teach traditional git/GitHub today, but here are some recommendations if you'd like to learn. First, read Jenny Bryan's "Excuse Me, Do You Have a Moment to Talk About Version Control?" (open-access pre-print from [PeerJ](https://peerj.com/preprints/3159/), published in [The American Statistican](https://www.tandfonline.com/doi/full/10.1080/00031305.2017.1399928)). This provides an excellent overview. One quote I like in particular is +We aren’t going to teach traditional git/GitHub today, but here are some recommendations if you'd like to learn. First, read Jenny Bryan's "Excuse Me, Do You Have a Moment to Talk About Version Control?" (open-access pre-print from [PeerJ](https://peerj.com/preprints/3159/), published in [The American Statistican](https://www.tandfonline.com/doi/full/10.1080/00031305.2017.1399928)). This provides an excellent overview. One quote in particular: > Collaboration is the most compelling reason to manage a project with Git and GitHub. My definition of collaboration includes hands-on participation by multiple people, including your past and future self, as well as an asymmetric model, in which some people are active makers and others only read or review. - *Jenny Bryan, "Excuse Me, Do You Have a Moment to Talk About Version Control?"* -When you're ready to learn GitHub with R, the absolute best resource is Jenny Bryan's [Happy Git With R](https://happygitwithr.com/). This is a comprehensive, friendly step-by-step process of how to do so, and is an awesome reference for seasoned git/GitHub users as well. If you want a shorter-form resource, I'd recommend 2 tutorials from [R for Excel Users](https://rstudio-conf-2020.github.io/r-for-excel). This also teaches you how to set up GitHub to sync directly through RStudio, without any other software (including the command line) required to do so: see chapters on [GitHub](https://rstudio-conf-2020.github.io/r-for-excel/github.html) and [Collaborating with GitHub](https://rstudio-conf-2020.github.io/r-for-excel/collaborating.html#collaborating-with-github) +When you're ready to learn GitHub with R, the absolute best resource is Jenny Bryan's [Happy Git With R](https://happygitwithr.com/). This is a comprehensive, friendly step-by-step process of how to do so, and is an awesome reference for seasoned git/GitHub users as well. If you want a shorter-form resource, see the two GitHub tutorials in [R for Excel Users](https://rstudio-conf-2020.github.io/r-for-excel): [GitHub](https://rstudio-conf-2020.github.io/r-for-excel/github.html) and [Collaborating with GitHub](https://rstudio-conf-2020.github.io/r-for-excel/collaborating.html#collaborating-with-github). This resource also teaches you how to set up GitHub to sync directly through RStudio, without any other software (without the command line) required to do so. > On my local computer, I interact with GitHub through RStudio 99.9% of the time (use command line .1% of time). - Julie Lowndes @@ -76,7 +58,7 @@ We will talk about “Issues” & “Projects” in the next chapter. Example: [jules32](https://github.com/jules32) is a user account, [openscapes](https://github.com/openscapes) is an organization group. -You can think of them like other social media accounts: I can be an individual or part of a group, and there are permissions associated with both. +You can think of them like other social media accounts: you can be an individual or part of a group, and there are permissions associated with both. ### Repositories (“repos”) @@ -88,21 +70,21 @@ It makes it easier to navigate through and find stuff — so you are "not siftin Unlike Dropbox or Google Drive that constantly and automatically sync to the cloud, you have to deliberately tell git/GitHub when you have an amount of work that you want to be versioned and synced. You have to commit to telling them. GitHub takes care of the backend bookkeeping involved, but you have to write a human-readable message to your future self and others. That is the commit message. -There is no absolute guidance for how often to commit, but I think of it as leaving breadcrumbs for yourself. How much work and on what things/in what combination would you like to be able to reverse? What kind of information will make it easier for Future You to work with? +How often to commit depends on what you are doing: How much work and on what things/in what combination would you like to be able to reverse? What kind of information will make it easier for Future You to work with? -### Public vs private +> I think of GitHub commits as leaving breadcrumbs for yourself. - Julie Lowndes -You can have both public (the free default) and private repositories, and change these permissions later on. I mostly work in public repos, but if I work in private ones, I often have the expectation that they will be made public some day. So I practice good habits with commits and documentation, and keep conversations on-topic. +### Public vs private -### The search feature is awesome +You can have both public (the free default) and private repositories, and change these permissions later on. -You are able to search within a GitHub repository, across repositories in an organization, or across all GitHub public repositories. I find this helps me find things quickly if I'm looking for how I've used a function in the past, or if I remember a word that would stand out that I included in a commit message as a breadcrumb to myself. It will also search Issues within the repositories, so you can look for specific words in conversations as well. +> I mostly work in public repos, but if I work in private ones, I often have the expectation that they will be made public some day. So I practice good habits with commits and documentation, and keep conversations on-topic. - Julie Lowndes -### Branches & Forks +### The search feature is awesome -In our Champions GitHub Clinic, we do not talk about branches and forks of repositories. These are a core feature of what makes GitHub super powerful for software development, and one of the first things you'll see in GitHub tutorials geared towards software engineers. But I do not think that is the most relevant or smoothest entryway for those of us who are scientists fairly new to collaborative coding and version control. +You are able to search within a GitHub repository, across repositories in an organization, or across all GitHub public repositories. It will also search Issues within the repositories, so you can look for specific words in conversations as well. -> For the first 8 years as a GitHub user, I only worked in the Main branch with my small group of Ocean Health Index colleagues. It was only when working with the NASA Openscapes Mentors community that I learned how to use branches as software developers do. - Julie Lowndes +> I find this helps me find things quickly if I'm looking for how I've used a function in the past, or if I remember a word that would stand out that I included in a commit message as a breadcrumb to myself. - Julie Lowndes ## GitHub Orientation diff --git a/core-lessons/github/index.qmd b/core-lessons/github/index.qmd index 6ad278b..e151c7c 100644 --- a/core-lessons/github/index.qmd +++ b/core-lessons/github/index.qmd @@ -6,7 +6,7 @@ What is GitHub[^1], and what are GitHub strategies for Future Us? [^1]: From [Bryan 2017](https://peerj.com/preprints/3159/): "we're targeting GitHub - not Bitbucket or GitLab - for the sake of specificity. However, all the big-picture principles and even some mechanics will carry over to these alternative hosting platforms. We are advocating for the use of hosted version control as a general concept, with GitHub being the best and most common provider today." -GitHub is a powerful tool for collaborative coding with version control, but here and in our GitHub Clinic we are going to focus on some of its lesser-celebrated awesomeness. We'll talk about GitHub for supporting, reusing, contributing, and failing safely, as well as GitHub for publication and project management. We will focus on how to use GitHub for collaboration and communication for science, and spend time with hands-on practice. +GitHub is a powerful tool for collaborative coding with version control, but we are going to focus on some of its lesser-celebrated awesomeness. We'll talk about GitHub for publication and project management. We will focus on how to use GitHub for collaboration and communication for science, and spend time with hands-on practice. We begin with a friendly general introduction to GitHub and share examples and strategies used by some research groups. Following this are the two parts of the GitHub Clinic as we teach them in Champions Cohorts: 1) GitHub for publishing and 2) GitHub for project management. @@ -34,12 +34,8 @@ The Openscapes GitHub Clinic introduces GitHub with the motivation of collaborat ## GitHub for supporting, reusing, contributing, and failing safely -This introduction was developed with Allison Horst in the **GitHub Illustrated Series** ([Horst & Lowndes 2022](https://openscapes.org/blog/2022/05/27/github-illustrated-series/)): - **When we talk about managing projects to help us contribute, reuse, collaborate, and fail safely, we are talking about GitHub**. We mean using modern collaborative software designed to organize otherwise unwieldy interrelated files and to track changes by potentially different people through time -- something that is for everyone, whether or not we identify as "coders". People do use GitHub for code- and data-intensive projects, but we are not limited to that use. GitHub is a powerful approach for any project that we want to organize and communicate about; it's a way we can be open with ourselves and our teams, and also work more publicly as we feel comfortable. -So let's talk about why GitHub is so empowering for our project-oriented and collaborative lives. - ![](images/github_friends.png){fig-alt="A row of 6 cute smiling monsters celebrating using GitHub. The first, wearing a climbing harness labeled \"Me\" is high-fiving another whose harness says \"Future Me\". Others hold a box of snacks (tacos!), a map, a rope. Text above the monsters quotes Jenny Bryan: \\\"Collaboration is the most compelling reason to manage a project with Git and GitHub. My definition of collaboration includes hands-on participation by multiple people, including your past and future self, as well as an asymmetric model, in which some people are active makers and others only read or review" fig-align="center" width="85%"} See the **GitHub Illustrated Series** ([Horst & Lowndes 2022](https://openscapes.org/blog/2022/05/27/github-illustrated-series/)) for the full story! @@ -50,13 +46,13 @@ When we teach GitHub, we find it's useful to say explicitly that we should go in As part of this, we like how Jenny Bryan ([Code Smells and Feels](https://github.com/jennybc/code-smells-and-feels#code-smells-and-feels)) thinks about this - that your taste develops faster than your abilities. -![Slide from Jenny Bryan (Code Smells and Feels)](images/hedgehog-jenny-bryan.png){fig-align="center" width="80%"} - -## GitHub for research groups +## FAQs: GitHub for research groups As you get a better hands-on sense of GitHub's capabilities, you'll be thinking about how to get organized and use this for your own research group. -### Organizations +This section was created based on Frequently Asked Questions (FAQs) that Champions teams had during the GitHub Clinic. Read on to the next section for an introduction to GitHub via the GitHub Clinic. + +### What are example Organizations? Here are examples of GitHub Organizations created as part of Openscapes Champions Cohorts where the content is now developed and maintained to support a broader range of researchers. @@ -114,15 +110,15 @@ inactive or possibly created prior to Openscapes Cohort - --> ``` -### Repositories +### Size of repositories? -Repositories live inside an Organization. "Repos" are essentially folders, and you’ll put files and folders in them. How do we decide when we need a new repository? Should this be one repo per project or an organization-level repo? While there are many different approaches that could make sense for your group, our starting recommendation would be that any project happening in the research group gets its own repository, and that repository is in the research group's Organization. This is then clearly part of the research group's work and more findable by past/current/future members. And it can be forked/moved to other accounts at any time. +Restated: How do we decide when we need a new repository? Should this be one repo per project or an organization-level repo? -### Issues +Repositories live inside an Organization. "Repos" are essentially folders, and you’ll put files and folders in them. While there are many different approaches that could make sense for your group, our starting recommendation would be that any project happening in the research group gets its own repository, and that repository is in the research group's Organization. This is then clearly part of the research group's work and more findable by past/current/future members. And it can be forked/moved to other accounts at any time. -Issues and Projects are a great way to keep organized. See a few examples in the [NOAA Fisheries Resource Book](https://nmfs-opensci.github.io/ResourceBook/content/project_management/github_project_boards.html) and Openscapes [How We Work](https://github.com/Openscapes/how_we_work/issues) issues and [Planning](https://github.com/orgs/Openscapes/projects/13) project. +### How much should I write in a single Issue? -#### How much should I write in a single Issue? +Issues and Projects are a great way to keep organized. See a few examples in the [NOAA Fisheries Resource Book](https://nmfs-opensci.github.io/ResourceBook/content/project_management/github_project_boards.html) and Openscapes [How We Work](https://github.com/Openscapes/how_we_work/issues) issues and [Planning](https://github.com/orgs/Openscapes/projects/13) project. The "size" of each Issue is something you'll get a feel for as you use them more, so don't worry too much about it as you get started. The most common "size" of Issue is something you can complete, and close. This might include smaller checklists and conversations, but it is more along the lines of "change axes labels in my plot" rather than "write thesis chapter". @@ -130,15 +126,17 @@ Some Issues are also used more as reference and shared resources, and might not When you're logged into GitHub, go to to see all of the Issues assigned/created/etc for your account! -### Branches +### How I use Branches & Forks? Branches are a really powerful feature for software development, but aren't necessarily the right place for new GitHub users to get started. If there are a small number of people in a single repository and you're all first learning, we'd suggest that you start using GitHub without branches, and focus on checking in with each other as you contribute (see [R for Excel Users](https://rstudio-conf-2020.github.io/r-for-excel/collaborating.html#collaborating-with-github) example collaborating with GitHub from RStudio). +> For the first 8 years as a GitHub user, I only worked in the Main branch with my small group of Ocean Health Index colleagues. It was only when working with the NASA Openscapes Mentors community that I learned how to use branches as software developers do. - Julie Lowndes + Branches are powerful as your teams grow and/or as you become savvier with GitHub and code, so it is good to discuss strategies with them. -One approach is to treat each branch as very temporary: you make a branch from main, add your contribution, make a pull request, merge and delete the branch. This is the approach with the NASA Mentors and it's more continuous little updates rather than larger big updates, so we can make progress together more quickly. This also works better when working with Jupyter Notebooks, which can cause merge conflicts. +One common approach is to treat each branch as very temporary: you make a branch from main, add your contribution, make a pull request, merge and delete the branch. This is the approach with the NASA Mentors and it's more continuous little updates rather than larger big updates, so we can make progress together more quickly. This also works better when working with Jupyter Notebooks, which can cause merge conflicts. -#### Should we do everything in a `dev` branch? +### Should we do everything in a `dev` branch? Full question: "Right now any collaborative code in my group has a main branch and a dev branch. All collaborators clone the dev branch and push back to the dev branch on GitHub before anything ever goes to main. Is this best practice?" diff --git a/core-lessons/index.qmd b/core-lessons/index.qmd index 733c11b..e56778d 100644 --- a/core-lessons/index.qmd +++ b/core-lessons/index.qmd @@ -2,19 +2,15 @@ title: Core Lessons --- -## Better Science for Future Us +## Better science for future us -**Better science** is science that is more open, reproducible, efficient, interoperable, and also more diverse, equitable, inclusive, and kind. - -**Future Us** is the idea of considering ourselves, our teams, and communities - those who will be joining and continuing our work - whether that is in the next hour, week, or decades – and with a focus on onboarding ourselves and others to ongoing work. - -Together better science for future us is an important mindset for science and society at large, and particularly important as we face global challenges in Earth & environmental science and society that are intensified with climate change. +A guiding principle for Openscapes is "setter science for future us". -Better science for future us is a real time investment, particularly for data-intensive research. And it is something we can do together. +**Better science** is science that is more open, reproducible, efficient, interoperable, and also more diverse, equitable, inclusive, and kind. -This Series is going to be fun and empowering! We will talk about a lot of tools and practices to make your science more streamlined. This is really powerful, cool stuff, and not just for data: we made and published this book using the tools and workflows we'll talk about. +**Future us** is the idea of considering ourselves, our teams, and communities - those who will be joining and continuing our work - whether that is in the next hour, week, or decades – and with a focus on onboarding ourselves and others to ongoing work. -The first half of the Series focuses on efficiency and open culture within your team, and the second half is about sustained learning and bringing these practices to your broader communities. +Together better science for future us is an important mindset for science and society at large, and particularly important as we face global challenges in Earth & environmental science and society that are intensified with climate change. Better science for future us is a real time investment, particularly for data-intensive research. And it is something we can do together. ## Why we're here @@ -70,7 +66,7 @@ We're going to go through a lot and it's less important that you remember it all There are no skills required to participate, and we will not be teaching hands-on how to code or set up databases. But we will be talking about how these are important and fit together in the big picture, and how to get started learning the skills you need. This is an opportunity to discuss existing tools and how to engage, meet other research teams, discuss next steps, and stay accountable. -We'll talk about tools and practices broadly, but also with specific examples using R and GitHub. Won't that software eventually become outdated you say — is it worth learning them over something else? The answer is yes, software will change and become outdated; it always has. But seeing what is possible and becoming versed in embracing existing architecture and practices will set you up to make whatever transition comes, and you will make this transition with the community, not alone. Your skills will be transferrable skills as the actual software changes. Analogy: if you learn one musical instrument, you will be able to learn another one more fluidly than if you have never learned one to begin with because maybe you can read music, understand something about timing and rhythm, etc. +We'll talk about tools and practices broadly, but also with specific examples using R and GitHub. "Won't that software eventually become outdated?" you say — is it worth learning them over something else? The answer is yes, software will change and become outdated; it always has. But seeing what is possible and becoming versed in embracing existing architecture and practices will set you up to make whatever transition comes, and you will make this transition with the community, not alone. Your skills will be transferrable skills as the actual software changes. Analogy: if you learn one musical instrument, you will be able to learn another one more fluidly than if you have never learned one to begin with because maybe you can read music, understand something about timing and rhythm, etc. ### Everyone is coming with different experiences & expectations @@ -99,27 +95,6 @@ Here is some of my vulnerability: You are all welcome here, please be respectful of one another. We are setting a tone of mutual respect and a space place for learning where we assume good intentions and interact with kindness and empathy. Pass it on. -## What's possible with open data science (demo) - -- R for automation, visualizations -- github for collaborating (code, text) -- bookdown -- websites -- github for project management - - organize by *project*, i.e., keep that code and those methods in same parent folder, rather than all the R code you've ever written being in a giant folder, spanning projects - - public & private issues, tagging people on commits, kaban board - -Live: fix a tpyo and republish the book/page - -```{=html} - -``` ## What we'll learn ### Expect that there is a better way @@ -130,7 +105,7 @@ Seeing what's possible opens up what you expect. There is a bit of a chicken and Break down that “I teach you learn” model. We are all here to learn and improve. Learning horizontally. -This series is not about micro-managing your science but about providing guidance & structure so that everyone on your team is not silently struggling to reinvent the wheel and coming up with weird homegrown data approaches. +This series is not about micro-managing your work but about providing guidance & structure so that everyone on your team is not silently struggling to reinvent the wheel and coming up with weird homegrown data approaches. What skills you should have and what you should be thinking of, along with some of the tools you can use. Will be building out the Resources page on the website for this purpose. And search the blogs. @@ -138,43 +113,9 @@ What skills you should have and what you should be thinking of, along with some No more silently struggling & reinventing the wheel & creating weird, homegrown workarounds. -Embrace emerging and established community best practices +Embrace emerging and established community best practices. And find/grow community within your organization, which especially helps with remote/hybrid work and onboarding new hires. ### Identify what skills and tools you need, map next steps & learn We will introduce concepts, tools, and workflows and start creating a shared culture around them. That can mean knowing what skills or tools to learn or how to help someone else. -## Deliverables - -Also known as outcomes you can communicate with your supervisors. - -- A more open culture in your group, in part via: - - regular, dedicated group meetings to skill-share, discuss workflows, & build psychological safety (**“seaside chats”**, [Lowndes et al. 2019](https://openscapes.github.io/supercharge-research/), [2024](https://onlinelibrary.wiley.com/doi/10.1002/ece3.11341)) - - beginnings of a group **pathway** (roadmap) of how you work and next steps for shared workflows -- Be agents of change for open science in your groups, departments, communities, and part of a networked global movement for kinder, open practices and culture change - -### What would you do in a Seaside Chat? - -Example topics: - -- Let’s organize folders and have READMEs so we know what things belong where -- Where to put data – here’s how our server works -- Let's ask how each other are doing and help identify and address common challenges -- Set up Zotero with RMarkdown -- Filepath woes: R users use .Rprojects and `here` package -- Let's screenshare using Chat/Slack/etc and have a shared plan for how we communicate with each other and get help. -- Let’s plan a group “hackathon” to move these .xls to .csv files we store on Github - -Example lessons from the Ocean Health Index team's Seaside Chats ([Lowndes et al. 2017](https://www.nature.com/articles/s41559-017-0160)): - -- [Introduction to GitHub](https://github.com/eco-data-science/github-intro-2) -- [Text analysis in R](https://github.com/oharac/text_workshop) -- [Spatial analysis in R](https://github.com/eco-data-science/spatial-analysis-R) -- [Free websites with RMarkdown](https://jules32.github.io/rmarkdown-website-tutorial/) -- [Animated plots in R with ggplot2 & gganimate](https://raw.githack.com/allisonhorst/eds-ggplot2-gganimate/master/gganimate_key.html) - -### Coworking - -Attending Cohort Calls is not enough, to apply what you learn to your work, build habits, and troubleshoot, you will need to dedicate additional time. At a minimum, we recommend 1.5 hours each week to review what you learned, develop your Pathway document, and try things on your own work. This time is designed to be done during team "Seaside chats", weekly meetings to discuss data workflows and establish shared practices, or Coworking, where Openscapes Mentors will be there to help answer questions and demo additional examples. - -Reflection is important for skill-building; come prepared to reflect and share in the following Cohort Call! diff --git a/core-lessons/mindset.qmd b/core-lessons/mindset.qmd index 99c886d..1646301 100644 --- a/core-lessons/mindset.qmd +++ b/core-lessons/mindset.qmd @@ -34,7 +34,7 @@ Redefining collaborators and community opens opportunities for new perspectives, **Reimagine challenges -- expect there is a better way** -Reimagining challenges is based on the idea that there is a better way that already exists — and that you can find and make use of it. It is the idea of reusing rather than reinventing. It is a release from lonely struggles that also reduces the cognitive load associated with starting from scratch. This means no more silently struggling, reducing the times you reinvent the wheel, and reducing the times you create weird, homegrown workarounds. +Reimagining challenges is based on the idea that there is a better way that already exists — and that you can find and make use of it. It is the idea of reusing rather than reinventing. It is a release from lonely struggles and that release also reduces the cognitive load associated with starting from scratch. This means no more silently struggling, reducing the times you reinvent the wheel, and reducing the times you create weird, homegrown workarounds. Expecting there's a better way will help you focus on asking for help sooner, to find what you need faster, iterate with confidence & agency. diff --git a/core-lessons/pathways.qmd b/core-lessons/pathways.qmd deleted file mode 100644 index b5eb20a..0000000 --- a/core-lessons/pathways.qmd +++ /dev/null @@ -1,87 +0,0 @@ ---- -title: Pathways ---- - -This page has guidance and examples around the Pathways document; to learn more about what teams accomplish, explore [stories from previous cohorts](https://openscapes.org/blog#category=champions). - -## The concept - -Perhaps the most important part of Openscapes is helping teams identify their trailhead together, as illustrated in the Champions [landscape illustration](/index.qmd#welcome). - -::: column-margin -![](../images/horst_openscapes_champions.jpg){fig-align="center"} -::: - -We support individuals to "find their teams" by discussing approaches and software, so that they find they have common parts of how they work, whether they are working on the same or different projects. This builds from the ideas of creating space and place in order to find the common, as introduced in the [better science](/core-lessons/better-science.qmd#pathways-better-science) chapter. - -::: {.callout-warning icon="false"} -## Slides - -The Pathway Intro slides in the latter part of this deck were presented in a Champions Cohort. - -[Documentation & the Pathway](https://docs.google.com/presentation/d/1vuZVu7YXyKAgCAM65hjdalvUyimIqnL94BDDsoM-uxI/) -::: - -The Pathways Spreadsheet provides a structured way for your team to think how you work and find common approaches and needs ([template](https://docs.google.com/spreadsheets/d/1rmhOly87OYrPOUqTzmccYbPrTlGmXGsN06GI1FKzxag/edit?usp=sharing)). - -![Example Pathway Spreadsheet documenting how the team is working now and ideas for next steps](images/pathway-example.png) - -This format has helped many groups think through their trailhead and identifying where they are now. Some groups have found it more useful to draw things out as a workflow on a whiteboard or google slide. The spreadsheet format might not work for your group, and that is okay; use whatever format makes sense for you. - -## Planning guidance - -You'll develop your Pathway by talking with others on your team, screensharing ("show me"), and asking questions. - -You'll use the document by creating a copy of the template and then discussing with your team. Start with the "Now" column. How do you work now? Add rows as best reflects your work, but take a moment before deleting them in case it's something you haven't thought about in this way before rather than if it's not relevant to you. Then, move on to the "Next Steps" column as you think through priorities and learn from/with/for your cohort. This will be a work in progress throughout the cohort that you'll present a snapshot of in the final Cohort Call (see next) and that you can revisit following the cohort as well. - -## Presenting guidance - -On the final Cohort Call, each team presents their Pathways. Each team has 3 minutes to share followed by 2 minutes for questions. We encourage leads not to present, and it's great when we hear multiple voices from the teams. - -**This is informal sharing of unpolished work-in-progress.** Everyone makes progress throughout the Cohort: in mindsets, planning and actions. This is an opportunity to reflect and talk about it, building on the reflection breakout rooms that began most Cohort Calls. We've been reflective each week and we've all made progress. - -Presentations do not need be line-by-line of the Pathways Spreadsheet and there's no wrong way to talk about your progress. Whatever your group wants to create and share is great - could be a photo of a whiteboard, a slide, the Pathways spreadsheet, or a "screenshare and tell" live walk-through of your files/code/ideas. - -A few reflection prompts that can help frame the presentations: - -- What are the practices we've covered during the Cohort that most compel you? -- What are the practices we've covered during the Cohort that most confuse you? -- Are there practices that are new to you that you didn't originally think would work with your own research interests? If so, which? -- What are your two biggest take-aways from the Cohort? -- What future revisions will you propose making for your pathway? -- Any final questions you want to workshop with the Cohort? - -## Pathways stories - -Here are a few one-slide pictures of Pathways presented by Champions teams in their final sessions: - -![An example of an Openscapes pathway written by the NOAA Alaska Fisheries Science Center EcoFOCI team. The diagram summarizes how they used to share code, data, and files, and what their ongoing plans are for streamlining these processes and creating a team culture of openness and psychological safety. Source: [A supportive forum for continued learning and collaboration at NOAA Fisheries Alaska](https://www.openscapes.org/blog/2022/04/07/afsc-supportive-forum/)](images/afsc-ecofoci.png) - -
- -![NOAA Northwest Fisheries Science Center Ecosystem Status Report Automation team was united by working on reports with many contributors of maps, time series data that must be compiled into 20-page reports. Source: [Nationwide Openscapes Training at NOAA Fisheries Science Centers: Facilitating Collaboration, Skill-sharing, and Open Science](https://openscapes.org/blog/2023-01-24-noaa-nmfs-fall/)](images/2022-noaa-nwfsc-fall-esr.png){fig-alt="flow diagram outlining data files, code, analysis output, end product, the types of data, their locations, and the people who must manually interact with specific components" fig-align="center" width="589"} - -
- -![The NOAA Southeast Fisheries Science Center Trawl and Plankton Branch team focused on "Where are we going and how do we get there", and plans to do better documentation, use GitHub, which in the near-term involves setting up discussions to include more team members and set up collaborative processes. Source: [Nationwide Openscapes Training at NOAA Fisheries Science Centers: Facilitating Collaboration, Skill-sharing, and Open Science](https://openscapes.org/blog/2023-01-24-noaa-nmfs-fall/)](images/2022-noaa-sefsc-fall-tpb.png){fig-alt="diagram with question mark in center surrounded by 3 boxes labelled Current Responsibilities, Challenges, End Goal" fig-align="center" width="588"} - -
- -![Screenshot from the ADRIFT Field Methods website created through the Openscapes Program. This is a living document where we can outline our methodology and update/archive specific components of our methods and hardware as changes are made. Credit: NOAA Fisheries / Kourtney Burger. Source: [Sound Bytes: Championing Open Science](https://www.fisheries.noaa.gov/science-blog/sound-bytes-championing-open-science){.uri}](images/swfsc-sael-site-kourtney-burger.jpg){fig-alt="screenshot of web page. Left navigation bar with round NOAA logo above a table of contents. Right side has text titled Summary above a diagram of drifting acoustic buoy" fig-align="center" width="522"} - -### Read more - -- [Champions Program blog posts](https://openscapes.org/blog#category=champions); you'll find more Pathways shared as slides and stories following the 2-month cohort - -- [A TL;DR Collection of Stories from Openscapes Champions and Mentors](https://docs.google.com/presentation/d/1YAnaRFsKX3H6cSTXoOl-GksH-eebifQ6vzN7UwfoXUY/edit?usp=sharing); these stories are largely from 3 months+ following Pathways presentations - -```{=html} - -``` diff --git a/core-lessons/team-culture.qmd b/core-lessons/team-culture.qmd index 89d4025..ee6cbff 100644 --- a/core-lessons/team-culture.qmd +++ b/core-lessons/team-culture.qmd @@ -4,7 +4,7 @@ aliases: - ../team-culture.html --- -We discuss team culture because while we know that [diverse teams are more innovative](https://www.scientificamerican.com/article/how-diversity-makes-us-smarter/), creating spaces where everyone can do their best work and feel safe to contribute takes intention; it does not happen by default. There is a lot of work to do to improve research culture, and we can lead by example in our own research groups and communities. +We discuss team culture because while we know that [diverse teams are more innovative](https://www.scientificamerican.com/article/how-diversity-makes-us-smarter/), creating spaces where everyone can do their best work and feel safe to contribute takes intention. It does not happen by default. There is a lot of work to do to improve research culture, and we can lead by example in our own research groups and communities. ::: {.callout-warning icon="false"} ## Slides @@ -57,29 +57,20 @@ Role modeling sets a lot of team culture, and there is a lot we can learn and do ## Psychological safety -Amy C. Edmondson is the Novartis Professor of Leadership and Management at Harvard Business School. +Psychological Safety is defined as "a shared belief that team members will not be rejected or embarrassed for speaking up with their ideas, questions, or concerns". This is work by Dr. Amy Edmondson, the Novartis Professor of Leadership and Management at Harvard Business School. -a shared belief that team members will not be rejected or embarrassed for speaking up with their ideas, questions, or concerns +In the article [Research: To Excel, Diverse Teams Need Psychological Safety](https://hbr.org/2022/03/research-to-excel-diverse-teams-need-psychological-safety), Edmonson & Bresman recommend three ways to build psychologically safe environments: framing, inquiry, and bridging boundaries. -https://hbr.org/2022/03/research-to-excel-diverse-teams-need-psychological-safety - -They recommend three ways to build psychologically safe environments: framing, inquiry, and bridging boundaries. - -Frame meetings as opportunities for information-sharing. Frame differences as a source of value. - -Open questions. Questions that build shared ownership and causality. - -Listening - - -``` -Hopes and goals. What do you want to accomplish? -Resources and skills. What do you bring to the table? -Concerns and obstacles. What are you up against? What are you worried about? -``` +- Frame meetings as opportunities for information-sharing. Frame differences as a source of value. +- Open questions. Questions that build shared ownership and causality. +- Listening - by asking questions around + - Hopes and goals. What do you want to accomplish? + - Resources and skills. What do you bring to the table? + - Concerns and obstacles. What are you up against? What are you worried about? ### Science benefits from diversity -And we need to be deliberate about welcoming and including people from diverse backgrounds. +We need to be deliberate about welcoming and including people from diverse backgrounds. A few articles from Nature with many more links within: @@ -109,23 +100,21 @@ Have to build trust and be intentional, don’t hope for organic. ### Sustain the culture -Overtly showing kindness & a Code of Conduct can filter out people who don’t want to be subject to its enforcement – [rOpenSci](https://ropensci.org/blog/2016/12/21/commcallv12-review-coc/) +Overtly showing kindness & a Code of Conduct can filter out people who don’t want to be subject to its enforcement – [rOpenSci](https://ropensci.org/blog/2016/12/21/commcallv12-review-coc/). Research teams have people coming and going all the time; how do you set the tone and have it be sustainable? ## Deliberately setting the tone -Opening remarks at RStudio::conf 2019, in front of an audience of 1700 at a global software conference, Chief Scientist Hadley Wickham announces the Code of Conduct, how to identify RStudio staff if you need help, and how to mingle with welcoming body posture to invite others to join. This set the tone of the whole conference to be the most positive I have ever attended. +Opening remarks at RStudio::conf 2019, in front of an audience of 1700 at a global software conference, Chief Scientist Hadley Wickham announces the Code of Conduct, how to identify RStudio staff if you need help, and how to mingle with welcoming body posture to invite others to join. This set the tone of the whole conference to be the most positive many people have ever attended. ### Collegiality -We must deliberately set the tone for collegiality to create a positive, inclusive research group environment. This builds on the [Openscapes Mindset](mindset.qmd). - -Safety and accessibility are parts of inclusion and empowerment. Does everyone feel safe to speak up? Does everyone have channels to contribute? This is especially true as the tech we use evolves. Who can participate? +We must deliberately set the tone for collegiality to create a positive, inclusive research group environment. Safety and accessibility are parts of inclusion and empowerment. Does everyone feel safe to speak up? Does everyone have channels to contribute? This is especially true as the tech we use evolves. Who can participate? > "*This builds resilience to your research group. If someone needs to leave for a family emergency, maternity/paternity leave, vacation, set yourselves up so your team continue smoothly*" — Angela Bassa in her rstudio::conf 2019 talk "[Data Science as a Team Sport](https://forum.posit.co/t/data-science-as-a-team-sport-angela-bassa-rstudio-conf-2019l-video/24858/1)" -The opportunity cost of not doing this is burnout, and people leaving science. +The opportunity cost of not doing this is low morale, burnout, staff turnover, and people leaving science. diff --git a/how-do-i/do-fix-git-things.qmd b/how-do-i/do-fix-git-things.qmd index 1bba076..658fb77 100644 --- a/how-do-i/do-fix-git-things.qmd +++ b/how-do-i/do-fix-git-things.qmd @@ -56,3 +56,4 @@ By Dr. Eli Holmes [Not just for programmers: How GitHub can accelerate collaborative and reproducible research in ecology and evolution](https://besjournals.onlinelibrary.wiley.com/doi/10.1111/2041-210X.14108) Braga et al 2023 provides 12 ways researchers in ecology and evolution use GitHub, as well as resources and examples of researchers using and learning GitHub. + diff --git a/how-do-i/index.qmd b/how-do-i/index.qmd index 06afc8b..4fdf8c3 100644 --- a/how-do-i/index.qmd +++ b/how-do-i/index.qmd @@ -3,3 +3,4 @@ title: "How Do I..." --- This is a collection of resources that complement what we cover in the Champions Lesson Series - things that often come up as questions and that folks can screenshare and do together during Seaside Chats and Coworking sessions. We point to existing resources as much as possible. + diff --git a/how-do-i/refactor-modularize-code.qmd b/how-do-i/refactor-modularize-code.qmd index fb7a967..a8271b7 100644 --- a/how-do-i/refactor-modularize-code.qmd +++ b/how-do-i/refactor-modularize-code.qmd @@ -26,4 +26,4 @@ Abstract: > Functional programming (FP) provides a rich set of tools for reducing duplication in your code. The goal of FP is to make it easy to express repeated actions using high-level verbs. I think that learning a little about FP is really important for data scientists, because it's a really good fit for many problems that you'll encounter in practice. In this talk, I'll introduce you to the basics of functional programming in R, using the purrr package. I'll begin by briefly dissecting the for loop that you're already familiar with, then continue to show why functional programming provides elegant alternatives. I'll next dive into two examples showing where FP is particularly useful in data science: when ingesting unruly datasets spread across multiple files, and producing multiple reports for different stakeholders. -You'll get the most out of this talk if you're familiar with R, or you've done data science in other languages like Python. \ No newline at end of file +You'll get the most out of this talk if you're familiar with R, or you've done data science in other languages like Python. diff --git a/how-do-i/setup-rstudio-github.qmd b/how-do-i/setup-rstudio-github.qmd index f032d86..edf73f1 100644 --- a/how-do-i/setup-rstudio-github.qmd +++ b/how-do-i/setup-rstudio-github.qmd @@ -24,4 +24,4 @@ It's developed by [Sean Kross](https://seankross.com/), who also co-created the ### R and GitHub together -Now you'll want to practice how to use RStudio and GitHub. Follow [R for Excel Users' GitHub Chapter](https://rstudio-conf-2020.github.io/r-for-excel/github.html) to create a GitHub repository, clone it to RStudio, make edits, and practice syncing. \ No newline at end of file +Now you'll want to practice how to use RStudio and GitHub. Follow [R for Excel Users' GitHub Chapter](https://rstudio-conf-2020.github.io/r-for-excel/github.html) to create a GitHub repository, clone it to RStudio, make edits, and practice syncing. diff --git a/core-lessons/images/2022-noaa-nwfsc-fall-esr.png b/images/2022-noaa-nwfsc-fall-esr.png similarity index 100% rename from core-lessons/images/2022-noaa-nwfsc-fall-esr.png rename to images/2022-noaa-nwfsc-fall-esr.png diff --git a/core-lessons/images/2022-noaa-sefsc-fall-tpb.png b/images/2022-noaa-sefsc-fall-tpb.png similarity index 100% rename from core-lessons/images/2022-noaa-sefsc-fall-tpb.png rename to images/2022-noaa-sefsc-fall-tpb.png diff --git a/core-lessons/images/afsc-ecofoci.png b/images/afsc-ecofoci.png similarity index 100% rename from core-lessons/images/afsc-ecofoci.png rename to images/afsc-ecofoci.png diff --git a/core-lessons/images/pathway-example.png b/images/pathway-example.png similarity index 100% rename from core-lessons/images/pathway-example.png rename to images/pathway-example.png diff --git a/core-lessons/images/swfsc-sael-site-kourtney-burger.jpg b/images/swfsc-sael-site-kourtney-burger.jpg similarity index 100% rename from core-lessons/images/swfsc-sael-site-kourtney-burger.jpg rename to images/swfsc-sael-site-kourtney-burger.jpg diff --git a/index.qmd b/index.qmd index 56ab612..f0c424a 100644 --- a/index.qmd +++ b/index.qmd @@ -9,129 +9,29 @@ slug: index ## Welcome {#welcome} -Hello! This is the lesson series for the [**Openscapes Champions program**](https://www.openscapes.org/champions/), an open data science mentorship program for science teams. This is a professional development and leadership opportunity for teams to reimagine data analysis and stewardship as a collaborative effort, develop modern skills that are of immediate value to them, and cultivate collaborative and inclusive research communities. Openscapes Champions is not a typical workshop --- its cohort-based remote sessions for teams introduces concepts and workflows, facilitates teams to talk about problems, then go and solve them with accountability and support. It is a remote-by-design program, launched in 2019. +Hello! This is the lesson series for the [**Openscapes Champions program**](https://www.openscapes.org/champions/), an open data science mentorship program for science teams. This is a professional development and leadership opportunity for teams to reimagine data analysis and stewardship as a collaborative effort, develop modern skills that are of immediate value to them, and cultivate collaborative and inclusive research communities. Champions is not a typical training workshop. **Through Openscapes cohorts, people focus on their own work and their own personal or team goals as they learn open science concepts, tooling, and practices with examples from their peers.** It is a remote-by-design program, launched in 2019. -![We think about open science like a landscape, with many paths forward. The Champions Program mentors researchers, meeting them at the trailhead to help them move from sad and lonely science to team science as they identify their common needs and start navigating the landscape together with a cohort of their peers. Artwork by Allison Horst.](images/horst_openscapes_champions.jpg){fig-alt="A landscape consisting of a grassy meadow next to a sandy beach and ocean, a winding river, and distant mountains. In the foreground, a sad bunny and skunk are working alone on their laptops, each with a rain cloud over their heads. Nearby is a trailhead with a fox holding a 'Welcome!' sign for a variety of different critters to see. Past the trailhead are branching pathways through the Openscapes landscape. No matter the path, however, there are small groups of animals working together to find their way. Nods to data science are scattered throughout the image, including mountains made of data points and a satellite in the sky" fig-align="center" width="70%"} +![We think about open science like a landscape, with many paths forward. The Champions Program mentors researchers, meeting them at the trailhead to help them move from lonely science to team science as they identify their common needs and start navigating the landscape together with a cohort of their peers. Artwork by Allison Horst.](images/horst_openscapes_champions.jpg){fig-alt="A landscape consisting of a grassy meadow next to a sandy beach and ocean, a winding river, and distant mountains. In the foreground, a sad bunny and skunk are working alone on their laptops, each with a rain cloud over their heads. Nearby is a trailhead with a fox holding a 'Welcome!' sign for a variety of different critters to see. Past the trailhead are branching pathways through the Openscapes landscape. No matter the path, however, there are small groups of animals working together to find their way. Nods to data science are scattered throughout the image, including mountains made of data points and a satellite in the sky" fig-align="center" width="70%"}
-All Champions Program resources are designed to also be a self-paced learning resource, and we know many people use the Champions Lesson Series for their own learning and for mentoring others, which is awesome. This Champions Lesson Series is improved openly and iteratively, and the most recent version always available online for reuse and remix. Each chapter in our **Core Lessons** focus on building a mindset and skillset for collaborative, reproducible workflows and culture within teams, while developing sustained learning practices connected with broader communities. +**All Champions Program resources are designed to also be a self-paced learning resource, and we know many people use the Champions Lesson Series for their own learning and for mentoring others, which is awesome.** This Champions Lesson Series is improved openly and iteratively, and the most recent version always available online for reuse and remix. Each chapter in our Core Lessons focus on building a mindset and skillset for collaborative, reproducible workflows and culture within teams, while developing sustained learning practices connected with broader communities. -See the [Champions Program webpage](https://www.openscapes.org/champions/) for programmatic details (including frequently asked questions like [what is a team](https://www.openscapes.org/faq/)). To learn what teams accomplish, explore [stories from 20+ previous cohorts](https://openscapes.org/blog#category=champions). - -## Purpose, Outcomes, Process (POP) - -This is the Champions Program [POP](https://suzannehawkes.com/2010/04/09/pop-everything/), a planning tool that we learned from the open science team at Mozilla. - -**Purpose:** to strengthen habits for immediate benefit that will help create long-lasting resilience in teams and workflows. We'll help you reimagine data analysis and stewardship through exploring open tools and practices; develop modern skills and habits that are of immediate value to you, including confidence and agency as leaders; cultivate collaborative and inclusive research communities with a Future Us mindset, starting with your team. - -**Outcomes:** different for everybody - this is about getting your own work done. Together we'll work on changing habits to improve your work and teamwork so you shape where you invest based on what you need. We'll develop a practice of reflecting, talking, and collaborating about data workflows with your team and community. You'll leave with a tangible Pathway (a planning document) that your team will use to help identify current practices and prioritize next steps. Your team will share your Pathway as work-in-progress during our last Cohort Call. Champions have found the Pathway valuable to communicate their needs and plans and to share with supervisors as a concrete outcome. - -**Process:** through facilitated Cohort Calls, team-driven Seaside Chats & Coworking, and How We Work (how we describe technical and cultural norms); Read on to learn more about these below. Additionally, every Champions Cohort includes at least one Mentor from the partner organization or community. Often a Mentor has participated in a Champions Cohort and expressed their interest in helping empower their colleagues as they build their open science and leadership skills, collaborate on solutions to common problems, and modernize their workflows. - -## Cohort Calls - -Research teams participate as a Champions Cohort with \~7 total teams over 2 months, meeting twice-monthly for five 1.5-hour sessions we call Cohort Calls. Teams focus on their own work. Each Cohort Call has two topics that introduce concepts, tooling, and examples from their peers, with time to reflect and discuss how the topics apply directly to our work. - -Cohort Calls are highly-structured and designed to be engaging, requiring discussion and active participation through scaffolded Agendas with shared live notetaking and breakout-group discussions. We begin each Cohort Call with a reminder of our [Code of Conduct](https://openscapes.org/code-of-conduct) and end each lesson with bite-sized Efficiency Tips and Inclusion Tips. Template agendas, as well as slides, tips, and other resources we use are openly available in this [Google Folder](https://drive.google.com/drive/folders/1Iq8tj81TSfr-RstphVTZWoz783xpJMOb), ready for reuse and remix. - -| Cohort Call Topics | Series Chapters | Seaside Chat Topics | -|--------------------|------------------------|----------------------------| -| 1\. Mindset, Better Science for Future Us | [mindset](core-lessons/mindset.qmd), [better science in less time](core-lessons/better-science.qmd) | Pathways trailhead - where are you now | -| 2\. GitHub Clinic: Publishing, Project Management | [publishing](core-lessons/github/github-pub.qmd), [project management](core-lessons/github/github-issues.qmd) | Shared organizing and onboarding | -| 3\. Team Culture, Data Strategies for Future Us | [team culture](core-lessons/team-culture.qmd), [data strategies](core-lessons/data-strategies.qmd) | Pathways next steps and documentation | -| 4\. Open Communities, Coding Strategies for Future Us | [open communities](core-lessons/communities.qmd), [coding strategies](core-lessons/coding-strategies.qmd) | Pathways share preparation | -| 5\. Pathways Share, Next Steps | [pathways](/core-lessons/pathways.qmd) | | - -You can find templates in this [Champions Cohorts Resources public folder](https://drive.google.com/drive/folders/1Iq8tj81TSfr-RstphVTZWoz783xpJMOb). - -## Seaside Chats & Coworking - -Between Cohort Calls, teams have synchronous spaces via Seaside Chats and Coworking to meet, ask questions, and exchange knowledge. Seaside Chats and Coworking have been described by participants as one of the most valuable parts of the Champions Program because it helps strengthen habits and a culture of shared workflows and learning. - -[**Seaside Chats**](https://www.openscapes.org/blog/2019/03/10/seaside-chats/) ([Lowndes et al. 2019](https://openscapes.github.io/supercharge-research/)) are when a team meets together independently for dedicated time for data/workflow discussions This is where teams talk and screenshare to begin identifying and addressing shared needs: Everyone has something to learn, ask, teach; don't need to be an expert in everything. Seaside Chats can include others that are not participating in the Champions Cohort. We'll provide suggestions for these meetings aligned with the [Pathways Document](/core-lessons/pathways.qmd) to organize your thoughts. The main purpose is to focus on your work at hand and build the habit of talking about and strengthening shared workflows with your broader group. We suggest you schedule these Seaside Chats with your team as soon as possible. - -Further, we facilitate optional **Coworking sessions**. Coworking comes in different flavors. For Champions Cohorts, coworking involves doing our own work at the same time together with opportunities to check in, and sometimes screenshare to get feedback or solve a problem. Seeing how other people work is a big part of this transition to working more openly and collaboratively. Some teams join Coworking together, meeting for their Seaside Chat in a breakout room with the option of talking to others in the Cohort. We will share optional Coworking times where you are welcome to come do your own work in a social setting. - -## How We Work - -"How We Work" refers to the technical and cultural norms we will establish during the Champions Cohort, which we developed through our [Openscapes Flywheel](https://openscapes.org/approach#openscapes-flywheel) ([Robinson and Lowndes 2022](https://eartharxiv.org/repository/view/4560/)). These approaches have become some of the most valuable things teams take with them through the Champions Program, and we love hearing how folks are taking these practices to new places as they grow as leaders. - -### Welcome - -We are intentional to create a welcoming environment, through art, design, and clear norms. You are all welcome here. We are creating a positive learning space where everyone is welcome to ask questions and participate. We'll start off each call with a reminder of our [Code of Conduct](https://www.openscapes.org/code-of-conduct/). - -### Space & Place - -Together we will be creating space and place to learn, collaborate, and create shared workflows so that we aren't all responsible for this alone. - -Our Cohort will have a single **shared folder** (via Google Drive/ Microsoft Teams) that we will share ahead of time and will be linked from the calendar invite. This will have all resources specific to our Cohort. Each Cohort Call will have a highly-structured **Agenda document** so you know what is planned --- and so you can more easily catch up if your internet drops out. We use headers so that you can navigate via the Table of Contents view. (In Google Docs, you can enable Outline view by selecting View \> Show outline.) These agendas are for live-note taking throughout the Cohort Call. It is our shared responsibility to contribute & help document for future us; this is the main place for nonverbal contribution, side conversations, and to reinforce ideas. - -
- -![Example computer setup with Zoom & Google Docs side-by-side with windows narrowed to enable seeing faces and writing in the shared document. Credit: The Fay Lab](images/screenshot-gdoc-zoom-setup.png){fig-alt="screenshot of a laptop computer screen with Zoom & Google Docs side-by-side with windows narrowed" fig-align="center" width="70%"} - -During Cohort Calls, we **encourage videos on** ("faces on") -- but it is okay if this is not possible for any reason. In Zoom, you can enable Gallery View by clicking Settings \> Video \> Display up to 49 participants. We ask you to **mute liberally/quickly** to reduce background noise -- but please unmute to speak up at any point. You'll interact in small groups via breakout groups, this will help you reflect on your work and get to know each other. - -We have a **flipped approach to screensharing**. This shows up in two ways. First, we do not screenshare slides while presenting. Instead we provide links to slides and presenters indicate when everyone should advance to the next slide. This minimizes bandwith issues and enables everyone to zoom in, click on links, linger, and go back, as they prefer. Second, we do screenshare to demonstrate keyboard shortcuts, live examples of how we work, and troubleshoot. Screensharing to show current practices and ask for help is a big part of Coworking sessions and Seaside Chats. - -At the start of each Cohort, we send **Google Calendar invites** to everyone for all Cohort Calls and optional Coworking sessions. These include the Zoom link (or Teams / Google Meet) to join, and a link to the Cohort's shared Google Folder so we don't all have to hunt for those each time. - -We start and end on time. - -### Learning & Trust - -Learning new things is uncomfortable and it can feel vulnerable to ask questions. Through creating a welcoming space we can invest in learning and trust together. We know there is a range of technical experience -- by design! We are all here because we want to learn and improve our work around data-intensive science. We're all imperfect and learning together -- Openscapes team included. We're all accountable to each other. - -Examples of how teams strengthen learning and trust within their groups are captured in our Pathways share in the final Cohort Call. Common themes are, meeting regularly, knowing who and where to ask for help, and building shared documentation and resources to reduce emails asking where things are. - -### Work Openly - -We role model working openly throughout the Cohort by sharing ideas, resources, and screensharing. All our resources are created with the same tools we teach research teams (R, GitHub, Google Drive) and shared openly. During Cohort Calls, our Agenda and open facilitation style is part of working openly --- we iterate openly as facilitators and mentors, for example through adjusting the timing live in the Agenda document. - -We send **Digests** the week following each Cohort Call (early, on Monday or Tuesday). Each digest includes the Call's goals, links to the Call's agenda, slides, and recording, and some excerpts from the shared notes. These provide a touch point in the week between Calls. See examples: [2022-nasa-champions](https://github.com/NASA-Openscapes/2022-nasa-champions/labels/digest), [2022-noaa-afsc](https://github.com/Openscapes/2022-noaa-afsc/labels/digest), [2021-fdd](https://github.com/Openscapes/2021-fdd/labels/digest). - -Many teams begin working more openly via shared documentation, project management, metadata, file organization and naming, and code organization and interoperability, using tools like Google Drive/Microsoft Teams, GitHub, R, and Python. - -### Common Workflows - -We reuse what works from other places in our work (we sometimes talk about this as "forking", borrowing a term from GitHub where you make a copy in your own workspace so you don't have to start from scratch). This often shows up in Champions Cohorts with teams reusing the Agendas structure and the concepts of Seaside Chats and Coworking with their broader research groups. - -We discuss practices from different open communities, and teams contribute so that others can build from their work as well. - -### Inspire - -Storytelling and sharing what works is so valuable for others to learn from and be inspired by. Many concepts and possibilities are new, so there is value in the idea of "show me" in a way that resonates. - -Inspiring others happens in small moments, that can look like someone leaning forward in their chair saying "I want to do that" when someone else is screensharing during Coworking. It can mean asking for 5 minutes at the start of a meeting to share something new you learned. These moments also build up to real culture change as folks give talks to their organizational leadership and broader open communities, and the Flywheel turns again. - -## Supercharge Your Research - -If you have read this page, you are prepared for your Cohort! We're often asked what people can do to further prepare in advance. Additional suggested reading include: - -[**Our path to better science in less time using open data science tools**](https://www.nature.com/articles/s41559-017-0160) (Lowndes et al. 2017). This describes a marine science team's transition to open collaborative teamwork. It was the original inspiration for creating the Champions Program and heavily influences the Core Lessons. - -[**Supercharge your research: a ten-week plan for open data science**](https://openscapes.github.io/supercharge-research/) (Lowndes et al. 2019). This was co-authored with the inaugural Champions Cohort, capturing the most valuable take-aways for marine and environmental science early career faculty. - -[**Shifting institutional culture to develop climate solutions with Open Science**](https://onlinelibrary.wiley.com/doi/10.1002/ece3.11341) (Lowndes et al 2024, Ecology & Evolution). This was co-authored by Openscapes mentors across organizations – including NASA Earthdata, NOAA Fisheries, EPA, California Water Boards, Pathways to Open Science, Fred Hutch Cancer Center. - -See also other publications and presentations at [openscapes.org/media](https://openscapes.org/media). + ## About -[Openscapes](https://openscapes.org) is an approach and a movement that helps researchers and those supporting research find each other and feel empowered to conduct data-intensive science. Through a creative approach drawing inspiration and skills from many places, we provide structures for technical skill-building, collaborative teamwork, and inclusive community development. Our work builds from many others in the open movement. +### Openscapes -Read more about How We Work: +[Openscapes](https://openscapes.org) is an open source approach and movement that helps researchers and those supporting research find each other and feel empowered to conduct data-intensive science. Through a creative approach drawing inspiration and skills from many places, we provide structures for technical skill-building, collaborative teamwork, and inclusive community development. Our work builds from many others in the open movement. -- [Openscapes Approach Guide](https://openscapes.github.io/approach-guide) -- [The Openscapes Flywheel: A framework for managers to facilitate and scale inclusive Open science practices](https://eartharxiv.org/repository/view/4560/) (Robinson & Lowndes 2022) -- [Shifting institutional culture to develop climate solutions with Open Science](https://onlinelibrary.wiley.com/doi/10.1002/ece3.11341) (Lowndes et al 2024, Ecology & Evolution) -- [3 lessons from remote meetings we're taking back to the office](https://opensource.com/article/20/6/remote-meetings) (Lowndes, Cabunoc Mayes & Sansing 2020) -- [How to run a remote workshop, Openscapes/Open Leaders-style](https://openscapes.org/blog/2020-03-11-tips-remote-workshops/) (complementing blog post) +Learn more about Openscapes [initiatives](https://openscapes.org/initiatives) through our many other [open resources](https://openscapes.org/resources), [media](https://openscapes.org/media), and [events](https://openscapes.org/events), and [connect](https://openscapes.org/connect) with us. ### This Series Book -The Series is written (and always improving) to be used as a reference, to teach, as self-paced learning, and for reuse and remix. And also, awesomely, it's created with the same tools and practices we will be talking about: R/RStudio - originally [bookdown](https://bookdown.org/yihui/bookdown/) and now [quarto](https://quarto.org) - and GitHub. +The Series is written (and always improving) to be used as a reference, to teach, as self-paced learning, and for reuse and remix ("forking", to borrow a term from open source software). And also, awesomely, it's created with the same tools and practices we will be talking about: R/RStudio - originally [bookdown](https://bookdown.org/yihui/bookdown/) and now [quarto](https://quarto.org) - and GitHub. ### Citation @@ -145,61 +45,7 @@ The citation will look something like: Please visit the Lesson Series [DOI link](https://doi.org/10.5281/zenodo.7407246) to get the most recent version - the one above is not automatically generated and may be out of date if we release an updated version. -```{=html} - -``` - ------------------------------------------------------------------------ Creative Commons License  Openscapes is licensed under a Creative Commons Attribution 4.0 International License. -```{=html} - -``` diff --git a/pathways.qmd b/pathways.qmd new file mode 100644 index 0000000..733fd64 --- /dev/null +++ b/pathways.qmd @@ -0,0 +1,111 @@ +--- +title: Pathways and Outcomes +subtitle: The Pathways concept help people make and communicate progress about shifting their workflows with open science +aliases: + - core-lessons/pathways.html +--- + +2-month Champions Cohorts go by quickly. In our final session, each team shares what they’ve learned through their work-in-progress. Outcomes are different for each team or individual, depending on what they decided to focus on. + +Teams share their progress through our **Pathways concept** that frames how they work now and where they would like to go in terms of reproducibility, collaboration, communication, and culture. Practically speaking, this is the Pathways spreadsheet document, a template that builds off of [Table 1 from Lowndes et al. 2017](https://www.nature.com/articles/s41559-017-0160/tables/1), but we’ve added this fourth important “culture” category so teams can be explicit about their plans for diversity, equity, inclusion as well as reproducibility, collaboration, and communication. Read on for example stories and guidance. + +## Pathways stories + +"Show-not-tell" is an important concept in Openscapes, particularly since "what does open science look like"? is a question often asked. + +Below are a few one-slide pictures of Pathways presented by Champions teams in their final sessions. For deeper details, [scroll the blogs](https://openscapes.org/blog#category=champions) on what Champions teams and individuals have accomplished in the 24+ Champions Cohorts over the past 5 years. People often describe what they will do next, and then we see how they've implemented those plans in the optional 3-month check-in we host after the cohort conclusion. + +
+ +![An example of an Openscapes pathway written by the NOAA Alaska Fisheries Science Center EcoFOCI team. The diagram summarizes how they used to share code, data, and files, and what their ongoing plans are for streamlining these processes and creating a team culture of openness and psychological safety. Source: [A supportive forum for continued learning and collaboration at NOAA Fisheries Alaska](https://www.openscapes.org/blog/2022/04/07/afsc-supportive-forum/)](images/afsc-ecofoci.png){fig-align="center" width="85%"} + +
+ +![NOAA Northwest Fisheries Science Center Ecosystem Status Report Automation team was united by working on reports with many contributors of maps, time series data that must be compiled into 20-page reports. Source: [Nationwide Openscapes Training at NOAA Fisheries Science Centers: Facilitating Collaboration, Skill-sharing, and Open Science](https://openscapes.org/blog/2023-01-24-noaa-nmfs-fall/)](images/2022-noaa-nwfsc-fall-esr.png){fig-alt="flow diagram outlining data files, code, analysis output, end product, the types of data, their locations, and the people who must manually interact with specific components" fig-align="center" width="85%"} + +
+ +![The NOAA Southeast Fisheries Science Center Trawl and Plankton Branch team focused on "Where are we going and how do we get there", and plans to do better documentation, use GitHub, which in the near-term involves setting up discussions to include more team members and set up collaborative processes. Source: [Nationwide Openscapes Training at NOAA Fisheries Science Centers: Facilitating Collaboration, Skill-sharing, and Open Science](https://openscapes.org/blog/2023-01-24-noaa-nmfs-fall/)](images/2022-noaa-sefsc-fall-tpb.png){fig-alt="diagram with question mark in center surrounded by 3 boxes labelled Current Responsibilities, Challenges, End Goal" fig-align="center" width="85%"} + +
+ +![Screenshot from the ADRIFT Field Methods website created through the Openscapes Program. This is a living document where we can outline our methodology and update/archive specific components of our methods and hardware as changes are made. Credit: NOAA Fisheries / Kourtney Burger. Source: [Sound Bytes: Championing Open Science](https://www.fisheries.noaa.gov/science-blog/sound-bytes-championing-open-science){.uri}](images/swfsc-sael-site-kourtney-burger.jpg){fig-alt="screenshot of web page. Left navigation bar with round NOAA logo above a table of contents. Right side has text titled Summary above a diagram of drifting acoustic buoy" fig-align="center" width="85%"} + + +> “I didn’t think to find solutions, because I didn’t realize that there was a problem; I thought that this was just the nature of doing [ecological] research – an endless pile of confusingly named csv files and R scripts....Now that I can see all the ways that our lab has profited from this initial investment, I cannot imagine how I managed without Openscapes’ principles. Our lab is producing substantially more science of higher quality and we are making more of our underlying data and code publicly available as a direct result of Openscapes’ intervention.” - +Dr. Chelsea Wood, University of Washington + +See also [A TL;DR Collection of Stories from Openscapes Champions and Mentors](https://docs.google.com/presentation/d/1YAnaRFsKX3H6cSTXoOl-GksH-eebifQ6vzN7UwfoXUY/edit?usp=sharing); these stories are largely from 3 months+ following Pathways presentations. + +## Pathways concept + +The Pathways concept is put to practice by an actual document that provides a structured way for your team to think how you work and find common approaches and needs ([template](https://docs.google.com/spreadsheets/d/1rmhOly87OYrPOUqTzmccYbPrTlGmXGsN06GI1FKzxag/edit?usp=sharing)). + +This spreadsheet format has helped many groups think through their trailhead and identifying where they are now. Some groups have found it more useful to draw things out as a workflow on a whiteboard or google slide. The spreadsheet format might not work for your group, and that is okay; teams can use whatever format makes sense for them. + +::: {.callout-warning icon="false"} +## Slides + +The Pathway Intro slides in the latter part of this deck were presented in a Champions Cohort. + +[Documentation & the Pathway](https://docs.google.com/presentation/d/1vuZVu7YXyKAgCAM65hjdalvUyimIqnL94BDDsoM-uxI/) +::: + +![Example Pathway Spreadsheet documenting how the team is working now and ideas for next steps](images/pathway-example.png){fig-align="center" width="85%"} + + + +### Planning guidance + +*The following is written as guidance for people using the Pathways concept.* + +You'll develop your Pathway by talking with others on your team, screensharing ("show me"), and asking questions. + +You'll use the document by creating a copy of the template and then discussing with your team. Start with the "Now" column. How do you work now? Add rows as best reflects your work, but take a moment before deleting them in case it's something you haven't thought about in this way before rather than if it's not relevant to you. Then, move on to the "Next Steps" column as you think through priorities and learn from/with/for your cohort. This will be a work in progress throughout the cohort that you'll present a snapshot of in the final Cohort Call (see next) and that you can revisit following the cohort as well. + +### Presenting guidance + +On the final Cohort Call, each team presents their Pathways. Each team has 3 minutes to share followed by 2 minutes for questions. We encourage leads not to present, and it's great when we hear multiple voices from the teams. In the spirit of teamwork, many people co-present their Pathways, and provide plans for how they are moving from solo practices toward shared practices. + +**This is informal sharing of unpolished work-in-progress.** Everyone makes progress throughout the Cohort: in mindsets, planning and actions. This is an opportunity to reflect and talk about it, building on the reflection breakout rooms that began most Cohort Calls. We've been reflective each week and we've all made progress. + +Presentations do not need be line-by-line of the Pathways Spreadsheet and there's no wrong way to talk about your progress. Whatever your group wants to create and share is great - could be a photo of a whiteboard, a slide, the Pathways spreadsheet, or a "screenshare and tell" live walk-through of your files/code/ideas. + +A few reflection prompts that can help frame the presentations: + +- What are the practices we've covered during the Cohort that most compel you? +- What are the practices we've covered during the Cohort that most confuse you? +- Are there practices that are new to you that you didn't originally think would work with your own research interests? If so, which? +- What are your two biggest take-aways from the Cohort? +- What future revisions will you propose making for your pathway? +- Any final questions you want to workshop with the Cohort? + +```{=html} + +``` + + + + +## What is the impact of this? + +What do impacts look like after the Champions Program has completed? [NOAA Fisheries](https://nmfs-openscapes.github.io/) has participated in 10 Champions Cohorts (400 staff) since 2020, which helped scaffold plans for the [Biden-Harris Administration announces support for NOAA Fisheries’ data, infrastructure, and workforce modernization in part via Openscapes](https://www.fisheries.noaa.gov/media-release/biden-harris-administration-announces-34-million-modernize-noaa-fisheries-data). They may be the best example to answer the question "What does shifting to open science look like across a federal agency like NOAA, and what are the impacts to the efficiency and quality of their scientific products?": + +- [**A Year of Open Science Community Building at NOAA Fisheries (video)**](https://www.youtube.com/watch?v=n1VaV8f6qQE&list=PLChfyH8TVDGnB_zDCm8d9oonMomfk8v9X&index=14). Eli Holmes (NOAA Fisheries Open Science), Evan Howell (Director of the Office of Science and Technology), Megsie Siple (Alaska Fisheries Science Center), Amanda Bradford (Pacific Islands Fisheries Science Center), Brian Fadely (Alaska Fisheries Science Center Marine Mammal Stock Assessments), Vivian Matter (Branch Chief of Southeast Fisheries Science Center), Kathryn Doering (Office of Science and Technology), Christine Stawitz (Office of Science and Technology), Carissa Geravsi (Gulf of Mexico Integrated Ecosystem Assessment), Lynn Dewitt (California Current Ecosystem Assessment Team). Year of Open Science Culminating Conference, March 21, 2024. diff --git a/program-summary.qmd b/program-summary.qmd new file mode 100644 index 0000000..c1b2425 --- /dev/null +++ b/program-summary.qmd @@ -0,0 +1,42 @@ +--- +title: Program Summary +subtitle: Openscapes Champions is an open data science mentorship program for science teams +--- + +## Overview + +**Openscapes Champions helps people reimagine data analysis & stewardship as a collaborative effort, develop modern skills that are of immediate value to them, and cultivate collaborative and inclusive research communities.** The Champions program was built from experience and has supported professionals in academia, government, and non-profit groups — and we have the improved the program from their needs and from current practices in the open science community. This transformational 10-week program consists of biweekly, 1.5-hour remote group sessions, with additional optional coworking times. + +## Program Details + +```{=html} + +``` +**Openscapes Champions is a multi-month program that is led remotely and designed to ignite incremental and sustainable change within research groups --- and beyond.** The program remotely convenes a cohort of science teams (7-10 teams of up to 5 people; 40 people max) twice per month over two months for 1.5-hour video calls that we call Cohort Calls. This is not a workshop. It is cohort-based facilitated sessions to help people collaboratively evolve their work (work they’re already doing) with input from peers. It helps people reflect on and modernize how they work! + +**The Champions program is designed so that small time requirements over longer time frames fosters incremental change, accountability, and community building within the realities of people's busy schedules, varying expertise and needs.** Each Cohort Call uses the [Champions Lesson Series](https://openscapes.github.io/series) you are reading; it is an open curriculum that is openly iterated with new lessons and peer examples, and with the most recent version always available online. The core lessons were originally based on what was instrumental in the Ocean Health Index team's [path to better science in less time](https://www.nature.com/articles/s41559-017-0160), and each chapter includes slides for core and newly developed lessons taught and iterated for Cohort Calls. We start off each call with a reminder of our Code of Conduct and provide multiple channels for participation, including through silent contributions to the Agenda with live note-taking, breakout groups, and full-group discussions. Each call closes with an efficiency tip and an inclusion tip to incorporate into daily practice. + +**Participants attend as teams — or sometimes individuals or subsets from teams — and come prepared for engaged participation as a whole cohort and within smaller breakout groups.** Discussions focus around collaborative mindsets, norms, and software to enable open, reproducible, inclusive research, introducing tooling like R, Python, tidyverse, GitHub, RMarkdown/Quarto, Google Drive, JupyterHubs, metadata and practices from open source communities, inclusive design, psychological safely, facilitation techniques, with examples from relevant research domains including the Ocean Health Index and previous Champions. Teams intentionally have a mix of data/coding/documentation experience and responsibilities. All skills and interests welcome - there are no coding prerequisites to participate. + +**The Openscapes Champions program is designed so that everyone can learn new approaches and make progress, no matter where they are starting from.** People sometimes participate repeatedly over years and focus on new things each time. Each team creates a Pathway document to start thinking about where they are now in terms of the tools and practices for reproducibility, collaboration, communication, and culture. Throughout the Cohort, teams develop their Pathway to help identify, prioritize and articulate their needs and next steps. Pathway progress from each team is presented in the final session, which helps participants practice articulating their data workflow plans and needs, and see similarities and allies across the cohort to continue on these paths together. + +**With Cohort Calls occurring twice monthly on alternating weeks, the time in between each session enables participants to reflect and practice new concepts while the Openscapes team incorporates feedback and iterates to better support cohort needs.** One way we suggest reinforcing this is through a regular practice of self-organized team data-workflow meetings ("[Seaside Chats](https://openscapes.github.io/supercharge-research/)") in the alternating weeks between cohort calls. This gives people an opportunity to share their learning with their broader team or collaborators and to establish norms around data and code management and inclusive onboarding practices, and identify things they want to learn together and things they can teach each other. The Openscapes team also facilitates [Coworking sessions](https://onlinelibrary.wiley.com/doi/10.1002/ece3.11341), where people can do their own work at the same time together, with opportunities to check in, ask questions, and screenshare to get feedback or solve a problem. + +**The remote- and cohort-nature of the program is designed to reinforce each other's learnings and networks across participating teams.** This has been especially important for remote and hybrid work, onboarding new colleagues, and establishing the positive culture we want in science. It also has helped people develop leadership skills as they advance in their careers. We have led over 20 Champions Cohorts with over 700 participants from academia, federal and state agencies (US and Canada), and non profits. The value of the Champions program is that it has helped participants make progress on making their own workflows more efficient and reproducible, and it has helped them connect more with their peers. Further, it has also connected them across cohorts and other parts of open science and beyond, as we all contribute to changing the culture of science. + +
+ +```{=html} + +``` diff --git a/what-to-expect.qmd b/what-to-expect.qmd new file mode 100644 index 0000000..c95df24 --- /dev/null +++ b/what-to-expect.qmd @@ -0,0 +1,208 @@ +--- +title: What to Expect (Program Level) +--- + +Openscapes Champions is not a typical workshop. It is cohort-based facilitated sessions to help people collaboratively evolve their work (work they’re already doing) with input from peers. It helps people reflect on and modernize how they work! The sessions introduce concepts and workflows and facilitate teams to talk about problems, so they can go and solve them with accountability and support. Note that whether people participate as teams or as individuals, we focus on teamwork and provide opportunities for people to find common parts of their workflows and "find their teams" beyond any traditional definition, so that we can all help make science less lonely and more networked. + +## Purpose, Outcomes, Process (POP) + +This is the Champions Program [POP](https://suzannehawkes.com/2010/04/09/pop-everything/), a planning tool that we learned from the open science team at Mozilla. + +**Purpose** The purpose is to strengthen habits for immediate benefit that will help create long-lasting resilience in teams and workflows. We'll help you reimagine data analysis and stewardship through exploring open tools and practices; develop modern skills and habits that are of immediate value to you, including confidence and agency as leaders; cultivate collaborative and inclusive research communities with a Future Us mindset, starting with your team. + +**Outcomes.** Outcomes are different for everybody - this is about getting your own work done. Together we'll work on changing habits to improve your work and teamwork so you shape where you invest based on what you need. We'll develop a practice of reflecting, talking, and collaborating about data workflows with your team and community. You'll leave with a tangible Pathway (a planning document) that your team will use to help identify current practices and prioritize next steps. Your team will share your Pathway as work-in-progress during our last Cohort Call. Champions have found the Pathway valuable to communicate their needs and plans and to share with supervisors as a concrete outcome. + +**Process.** The Champions Program operates via facilitated Cohort Calls, team-driven Seaside Chats, and Coworking, and role modeling open science via How We Work — all of which are described more below. Additionally, every Champions Cohort includes at least one Mentor from the partner organization or community. Often a Mentor has participated in a Champions Cohort and expressed their interest in helping empower their colleagues while addressing needs specific to their organization. + +## Cohort Calls + +The main synchronous time during Champions Cohorts are twice-monthly 1.5-hour sessions we call Cohort Calls. Each Cohort Call has two topics that introduce concepts, tooling, and examples from their peers, with time to reflect and discuss how the topics apply directly to their work. + +Cohort Calls are highly-structured and designed to be engaging, requiring discussion and active participation through scaffolded Agendas with shared live notetaking and breakout-group discussions. We begin each Cohort Call with a reminder of our [Code of Conduct](https://openscapes.org/code-of-conduct) and end each lesson with bite-sized Efficiency Tips and Inclusion Tips. + +| Cohort Call Topics | Series Chapters | Seaside Chat Topics | +|--------------------|------------------------|----------------------------| +| 1\. Mindset, Better Science for Future Us | [mindset](core-lessons/mindset.qmd), [better science in less time](core-lessons/better-science.qmd) | Pathways trailhead - where are you now | +| 2\. GitHub Clinic: Publishing, Project Management | [publishing](core-lessons/github/github-pub.qmd), [project management](core-lessons/github/github-issues.qmd) | Shared organizing and onboarding | +| 3\. Team Culture, Data Strategies for Future Us | [team culture](core-lessons/team-culture.qmd), [data strategies](core-lessons/data-strategies.qmd) | Pathways next steps and documentation | +| 4\. Open Communities, Coding Strategies for Future Us | [open communities](core-lessons/communities.qmd), [coding strategies](core-lessons/coding-strategies.qmd) | Pathways share preparation | +| 5\. Pathways Share, Next Steps | [pathways](/core-lessons/pathways.qmd) | | + +Template agendas, as well as slides, tips, and other resources we use are openly available in this [Champions Cohorts Resources public folder](https://drive.google.com/drive/folders/1Iq8tj81TSfr-RstphVTZWoz783xpJMOb), ready for reuse and remix. + +## Seaside Chats & Coworking + +Between Cohort Calls, teams have synchronous spaces via Seaside Chats and Coworking to meet, ask questions, and exchange knowledge. + +**Seaside Chats** ([Lowndes et al. 2019](https://openscapes.github.io/supercharge-research/)) are when a team meets together independently for dedicated time for data/workflow discussions. Seaside Chats are where teams talk and screenshare to begin identifying and addressing shared needs. Everyone has something to learn, ask, teach; people do not need to be an expert to share what they know. Seaside Chats are encouraged to include others that are not participating in the Champions Cohort. The main purpose is to focus on the work at hand and build the habit of talking about and strengthening shared workflows with a broader group. We will provide suggestions about what you could focus on to get started. + +**Coworking** [(Lowndes et al. 2024)](https://onlinelibrary.wiley.com/doi/10.1002/ece3.11341) comes in different flavors. For Champions Cohorts, coworking involves people doing their own work at the same time together with opportunities to check in, and sometimes screenshare to get feedback or solve a problem. Seeing how other people work is a big part of this transition to working more openly and collaboratively. Some teams join Coworking together, meeting for their Seaside Chat in a breakout room with the option of talking to others in the Cohort. We will share optional Coworking times where you are welcome to come do your own work in a social setting. + +**Seaside Chats and Coworking have been described by participants as one of the most valuable parts of the Champions Program because it helps strengthen habits and a culture of shared workflows and learning.** See also: [\[Sea\]side Chats for data workflows](https://www.openscapes.org/blog/2019/03/10/seaside-chats/), a 2019 blog. + + + +## How We Work + +"How We Work" refers to the technical and cultural norms we will establish during the Champions Cohort, which we developed through our [Openscapes Flywheel](https://openscapes.org/approach#openscapes-flywheel) ([Robinson and Lowndes 2022](https://eartharxiv.org/repository/view/4560/)). These approaches have become some of the most valuable things teams take with them through the Champions Program, and we love hearing how folks are taking these practices to new places as they grow as leaders. + +### Common Workflows + +We reuse what works from other places in our work (we sometimes talk about this as "forking", borrowing a term from GitHub where you make a copy in your own workspace so you don't have to start from scratch). This often shows up in Champions Cohorts with teams reusing the Agendas structure and the concepts of Seaside Chats and Coworking with their broader research groups. + +We discuss practices from different open communities, and teams contribute so that others can build from their work as well. + +### Inspire + +Storytelling and sharing what works is so valuable for others to learn from and be inspired by. Many concepts and possibilities are new, so there is value in the idea of "show me" in a way that resonates. + +Inspiring others happens in small moments, that can look like someone leaning forward in their chair saying "I want to do that" when someone else is screensharing during Coworking. It can mean asking for 5 minutes at the start of a meeting to share something new you learned. These moments also build up to real culture change as folks give talks to their organizational leadership and broader open communities, and the Flywheel turns again. + +### Welcome + +We are intentional to create a welcoming environment, through art, design, and clear norms. "You are all welcome here." We aim to create a positive learning space where everyone is welcome to ask questions and participate. We start off each call with a reminder of our [Code of Conduct](https://www.openscapes.org/code-of-conduct/). + +### Space & Place + +Together we will create space and place to learn, collaborate, and create shared workflows so that we aren't all responsible for this alone. + +Each Cohort will have a single **shared folder** (via Google Drive/ Microsoft Teams) that we will share ahead of time and will be linked from a calendar invite so there are multiple ways to find it again. This will have all resources specific to each Cohort. Each Cohort Call will have a highly-structured **Agenda document** so people know what is planned --- and so they can more easily catch up if/when the internet drops out. We use headers so that it is possible to navigate via the Table of Contents view. (In Google Docs, you can enable Outline view by selecting View \> Show outline.) These agendas are for live-note taking throughout the Cohort Call. It is a shared responsibility to contribute & help document for Future Us; this is the main place for nonverbal contribution, side conversations, and to reinforce ideas. + +
+ +![Example computer setup with Zoom & Google Docs side-by-side with windows narrowed to enable seeing faces and writing in the shared document. Credit: The Fay Lab](images/screenshot-gdoc-zoom-setup.png){fig-alt="screenshot of a laptop computer screen with Zoom & Google Docs side-by-side with windows narrowed" fig-align="center" width="70%"} + +During Cohort Calls, we **encourage videos on** ("faces on") -- but it is okay if this is not possible for any reason. In Zoom, the Gallery View is enabled by clicking Settings \> Video \> Display up to 49 participants. We ask people to **mute liberally/quickly** to reduce background noise -- but unmute to speak up at any point. Participants will interact in small groups via breakout groups, which will help them reflect on how examples apply to their work and to get to know each other. + +We have a **flipped approach to screensharing**. This shows up in two ways. First, we do not screenshare slides while presenting. Instead we provide links to slides and presenters indicate when everyone should advance to the next slide. This minimizes bandwith issues and enables everyone to zoom in, click on links, linger, and go back, as they prefer. Second, we do screenshare to demonstrate keyboard shortcuts, live examples of how we work, and troubleshoot. Screensharing to show current practices and ask for help is a big part of Coworking sessions and Seaside Chats. + +At the start of each Cohort, we send **Calendar invites** to everyone for all Cohort Calls and optional Coworking sessions. These include the Zoom / Teams / Google Meet to join, and a link to the Cohort's shared Folder so we don't all have to hunt for those each time. + +We start and end on time. + +### Learning & Trust + +Learning new things is uncomfortable and it can feel vulnerable to ask questions. Through creating a welcoming space we can invest in learning and trust together. We know there is a range of technical experience and comfort in every cohort -- by design! Participants are all opting in to the cohort to learn and improve work around data-intensive science. Everyone is imperfect and learning together -- Openscapes team included. We build accountability to each other. + +Discussions focus around collaborative mindsets, norms, and software to enable open, reproducible, inclusive research, introducing tools like R, Python, tidyverse, GitHub, RMarkdown/Quarto, Google Drive, JupyterHubs and practices from open source communities, inclusive design, psychological safely, facilitation techniques, with examples from relevant research domains including the Ocean Health Index and previous Champions. + +Examples of how teams strengthen learning and trust within their groups are captured in our Pathways share in the final Cohort Call. Common themes are, meeting regularly, knowing who and where to ask for help, and building shared documentation and resources to reduce emails asking where things are. + +### Work Openly + +We role model working openly throughout the Cohort by sharing ideas, resources, and screensharing. All our resources are created with the same tools we teach research teams (R, GitHub, Quarto, Google Drive, JupyterHub) and shared openly. During Cohort Calls, the Agenda and open facilitation style is part of working openly --- we iterate openly as facilitators and mentors, for example through adjusting the timing live in the Agenda document. + +We send **Digests** the week following each Cohort Call (early, on Monday or Tuesday). Each digest includes the Call's goals, links to the Call's agenda, slides, and recording, and some excerpts from the shared notes. These provide a touch point in the week between Calls. See examples: [2022-nasa-champions](https://github.com/NASA-Openscapes/2022-nasa-champions/labels/digest), [2022-noaa-afsc](https://github.com/Openscapes/2022-noaa-afsc/labels/digest), [2021-fdd](https://github.com/Openscapes/2021-fdd/labels/digest). + +Many teams begin working more openly via shared documentation, project management, metadata, file organization and naming, and code organization and interoperability, using tools like Google Drive/Microsoft Teams, GitHub, R, and Python. + +## Supercharge Your Research + +We're often asked what people can do to further prepare in advance. Additional suggested reading include: + +[**Our path to better science in less time using open data science tools**](https://www.nature.com/articles/s41559-017-0160) (Lowndes et al. 2017). This describes a marine science team's transition to open collaborative teamwork. It was the original inspiration for creating the Champions Program and heavily influences the Core Lessons. + +[**Supercharge your research: a ten-week plan for open data science**](https://openscapes.github.io/supercharge-research/) (Lowndes et al. 2019). This was co-authored with the inaugural Champions Cohort, capturing the most valuable take-aways for marine and environmental science early career faculty. + +[**Shifting institutional culture to develop climate solutions with Open Science**](https://onlinelibrary.wiley.com/doi/10.1002/ece3.11341) (Lowndes et al 2024, Ecology & Evolution). This was co-authored by Openscapes mentors across organizations – including NASA Earthdata, NOAA Fisheries, EPA, California Water Boards, Pathways to Open Science, Fred Hutch Cancer Center. + +### Learn more about How We Work + +- [Openscapes Approach Guide](https://openscapes.github.io/approach-guide) +- [The Openscapes Flywheel: A framework for managers to facilitate and scale inclusive Open science practices](https://eartharxiv.org/repository/view/4560/) (Robinson & Lowndes 2022) +- [3 lessons from remote meetings we're taking back to the office](https://opensource.com/article/20/6/remote-meetings) (Lowndes, Cabunoc Mayes & Sansing 2020) + - [How to run a remote workshop, Openscapes/Open Leaders-style](https://openscapes.org/blog/2020-03-11-tips-remote-workshops/) (complementing blog post) + +See also other publications and presentations at [openscapes.org/media](https://openscapes.org/media). + +## Teams: FAQs + +One thing that makes Openscapes Champions Cohorts impactful is a focus on **teamwork**. People most often sign up as teams, with varying skillsets and responsibilities, perhaps with a shared project and perhaps not. People can also sign up as individuals. Some Champions have said that “finding their teams” during the cohort – finding what’s common and feeling less alone while learning skills with their peers – has been the most valuable part of Openscapes. + +Openscapes Champions was originally designed with academic research groups in mind, to provide resilience where there is high turnover and folks might be struggling with similar challenges around data analysis — while working on different projects. But over half of cohorts have been groups with different structures and needs, some producing big annual government reports or indicators! We expect — and design for — a range of technical ability and comfort with technology and open science concepts. The most important thing is that people opt-in who have interest in improving their work somehow and want to strengthen their collaboration and leadership skills. + +Here are answers to some Frequently Asked Questions (FAQs). + +### How many people participate? + +The Champions Program operates as cohorts of 7-10 teams of up to 5 people; 40 people max in the cohort. + +### Why do people join a Champions cohort? + +People join because they (as an individual or team): + +- Want to learn about or work with open Science +- Want to meet peers working on similar workflow or data issues +- Have a ‘big goal’ that involves changing how you work; you want to make progress on making your data and science workflows more efficient and reproducible + +### What is a team? + +There is a lot of flexibility in choosing your team. + +Teams do not need to be a formal research group; they can be collaborating in other ways. Team members do not all need to have technical or data interests, but share a curiosity and interest in improving something about how they work. Participants are expected to have ‘Seaside Chats’ together with their broader research groups in the weeks between Cohort Calls, so it is OK, and expected, that only a subset of a team participate. + +### What skills are required? Coding? GitHub? + +No. This is not a coding workshop. + +The purpose is strengthen relationships and shared systems with folks with different responsibilities and skills, so there is less reinventing and less knowledge lost. + +During the cohort, people focus on what is important to them, often something hard to do, something they want to change. Throughout the cohort, as Openscapes introduces modern concepts, tooling, and peer examples, people learn together and get unstuck through identifying and making progress on barriers. Each cohort call (90 minutes) has 30-40 minute of lessons and the rest of the time is you reflecting and discussing how this could help you with your own work. + +### How do I choose my team? + +Choosing your team can be based on interests around data analysis and around leadership. There are no prerequisite skills to participate, just an interest to learn and contribute. The "homework" between Champions sessions and beyond is to meet with your full research group (beyond workshop participants, and optional for the lead) to establish shared workflows and habits within the research group. + +>*How you define \"team\" is completely up to you and having one person be in the cohort and using in-between session \"seaside chats\" to bring back the information to another group is 100% fine. That is common in the cohorts. In my first Openscapes cohort, I was the only person from my project. My personal goal was to use the Openscapes structure to help a team that I am on figure out how to tackle some off-boarding tasks due to a retirement. During my second cohort, there were 2 team members in the cohort and 2 not in the cohort. We focused on standardizing our data to get ready for our GitHub served data package. For the 3rd cohort I am doing, ^2^⁄~3~ of our team is in the cohort as we start to get organized for a major revamp of our report into a reproducible workflow.* **- Eli Holmes (NOAA NWFSC, NMFS-Openscapes)** + +We e invite research group leads (faculty, lecturers, program managers, etc.) and members (students, analysts, lab managers, etc.) participate together as teams so that 1) everyone sees and values what is possible; 2) leads enable members to invest time to learn skills and develop shared workflows; 3) members have guidance, agency, and support to incorporate concepts into their work; and 4) everyone can make progress on what is important to them, while strengthening the community of practice within the research group, cohort and beyond. + +### What if I don’t have a team? + +That’s ok, please sign up! We’ll help you connect with participants who share some of your goals or needs. + +### Does a team need a shared research project? + +No, teams do not need to have a specific shared research project to participate. + +The idea is that by developing shared open data science habits within the research group, it will be easier to onboard new folks and offboard knowledge/data/code/etc when folks leave. And, as more and more research groups work this way, it can ease transitions between research groups (i.e. when people leave projects or students graduate). + +When there are formal research groups, we invite research group leads (faculty, lecturers, program managers, etc.) and members (students, analysts, lab managers, etc.) to participate together as teams so that 1) everyone sees and values what is possible; 2) leads enable members to invest time to learn skills and develop shared workflows; 3) members have guidance, agency, and support to incorporate concepts into their work; and 4) everyone can make progress on what is important to them, while strengthening the community of practice within the research group, cohort and beyond. + +### Is attendance required for all Cohort Calls? + +Yes; we do try to have everyone on the team attend all Cohort Calls – but know that sometimes that’s not possible. All the lessons, slides, and also recordings are available if people have to miss, but everyone should sign up expecting to be at the Cohort Calls. + +### Do I as the PI need to attend the Cohort Calls, or just my team? + +It’s important that team leads attend with their team. The Champions program is designed to reduce the burden for PIs in the long term and develop leadership within and across their teams. With this investment now, team leads and members will build resilient and enduring practices for their research group, even as that research group changes into the future. The idea is that together, the whole team sees what’s possible with open data science and builds confidence, ownership, and a shared pathway forward. Then it’s the entire team, not just the PI, who puts it to practice in between sessions. + +### Does a cohort need a shared research project or to be closely related? + +No, the cohort does not need a shared project; each team will work on what they need to for their own work. Teams within a cohort do not need to be closely related, but having teams somewhat related can be good for community building (i.e. environmental science as a domain or a specific agency within government). + +### Can we have smaller teams so more teams can participate in a cohort? + +From our experiences so far think that ~8 teams with 4-5 participants per team (maximum of ~40 participants) is a good size so there is time for everyone to be engaged and contributing (and not feeling like a passive webinar). Also, having a good amount of members per team is really key to the whole model of Openscapes: we want to reduce the amount of burden for PIs to have to relay info to their research groups. Having more members participate as a team in the Openscapes program helps more team members feel agency to build resilient systems with less transmission time. +