From 14d999198be437e11377e9d8ed93a8cde0ef4561 Mon Sep 17 00:00:00 2001 From: "Luke W. Johnston" Date: Tue, 16 Dec 2025 18:26:12 +0100 Subject: [PATCH 1/7] feat: :sparkles: post on running the two GitHub workshops --- posts/workshop-github-intro/create-plots.R | 50 +++ .../feedback-2025-05-26.svg | 353 ++++++++++++++++++ .../feedback-2025-09-09.svg | 309 +++++++++++++++ posts/workshop-github-intro/index.qmd | 93 +++++ posts/workshop-github-intro/overview.svg | 232 ++++++++++++ 5 files changed, 1037 insertions(+) create mode 100644 posts/workshop-github-intro/create-plots.R create mode 100644 posts/workshop-github-intro/feedback-2025-05-26.svg create mode 100644 posts/workshop-github-intro/feedback-2025-09-09.svg create mode 100644 posts/workshop-github-intro/index.qmd create mode 100644 posts/workshop-github-intro/overview.svg diff --git a/posts/workshop-github-intro/create-plots.R b/posts/workshop-github-intro/create-plots.R new file mode 100644 index 0000000..0e591a7 --- /dev/null +++ b/posts/workshop-github-intro/create-plots.R @@ -0,0 +1,50 @@ +# pak::pak("rostools/samwise", ask = FALSE) + +library(tidyverse) +library(samwise) + +overview <- read_surveys("gh_intro", "overview") +feedback <- read_surveys("gh_intro", "feedback-quantitative") + +plot_overview_community <- function(data) { + data |> + plot_overview() + + scale_fill_manual(values = rep("#196440", 14)) + + facet_grid( + cols = vars(date), + rows = vars(question), + scales = "free", + space = "free_y", + axes = "all_y", + labeller = ggplot2::label_wrap_gen(width = 10) + ) + + theme( + panel.border = element_rect(color = "grey85") + ) +} + +save_plot_feedback <- function(data) { + ggsave( + filename = glue::glue("feedback-{unique(data$date)}.svg"), + plot = plot_feedback(data) + + scale_x_continuous(breaks = seq(0, 12, by = 2)) + ) +} + +# Get numbers for workshop +overview |> + summarise(n = sum(count), .by = c(date, question)) |> + distinct(date, n) + +feedback |> + summarise(n = sum(n), .by = c(date, statement)) |> + distinct(date, n) + +ggsave( + filename = "overview.svg", + plot = plot_overview_community(overview) +) + +feedback |> + group_split(date) |> + walk(save_plot_feedback) diff --git a/posts/workshop-github-intro/feedback-2025-05-26.svg b/posts/workshop-github-intro/feedback-2025-05-26.svg new file mode 100644 index 0000000..698a644 --- /dev/null +++ b/posts/workshop-github-intro/feedback-2025-05-26.svg @@ -0,0 +1,353 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +In general, I think this was a good +workshop + + + + + + + + + +I think there was a good mix of +learning activities that encouraged my +active participation + + + + + + + + + +I think there was good alignment +between the learning activities + + + + + + + + + +I think this workshop has given me +enough of a solid, basic grasp of the +concepts that I feel confident about +continuing using and learning them in +my work + + + + + + + + + +I think I learned a lot from this +workshop + + + + + + + + + +I think the content on the website +clearly communicated the concepts + + + + + + + + + +I think the instructors clearly +communicated the concepts + + +0 +2 +4 +6 +8 +10 +12 +0 +2 +4 +6 +8 +10 +12 +0 +2 +4 +6 +8 +10 +12 +Number of responses +Responses + + + + + +Strongly agree +Agree +Neutral +Disagree +Strongly disagree + + + diff --git a/posts/workshop-github-intro/feedback-2025-09-09.svg b/posts/workshop-github-intro/feedback-2025-09-09.svg new file mode 100644 index 0000000..5f234eb --- /dev/null +++ b/posts/workshop-github-intro/feedback-2025-09-09.svg @@ -0,0 +1,309 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +In general, I think this was a good +workshop + + + + + + + + + +I think there was a good mix of +learning activities that encouraged my +active participation + + + + + + + + + +I think there was good alignment +between the learning activities + + + + + + + + + +I think this workshop has given me +enough of a solid, basic grasp of the +concepts that I feel confident about +continuing using and learning them in +my work + + + + + + + + + +I think I learned a lot from this +workshop + + + + + + + + + +I think the content on the website +clearly communicated the concepts + + + + + + + + + +I think the instructors clearly +communicated the concepts + + +0 +2 +4 +6 +0 +2 +4 +6 +0 +2 +4 +6 +Number of responses +Responses + + + + + +Strongly agree +Agree +Neutral +Disagree +Strongly disagree + + + diff --git a/posts/workshop-github-intro/index.qmd b/posts/workshop-github-intro/index.qmd new file mode 100644 index 0000000..44d32be --- /dev/null +++ b/posts/workshop-github-intro/index.qmd @@ -0,0 +1,93 @@ +--- +title: "Developed and ran a new workshop on how to use GitHub" +description: "We received several requests for running a workshop on using GitHub from collaborators and colleagues. So we developed a gentle introduction to using GitHub as part of our efforts to build up digitally technical capacity and upskill researchers to more effectively collaborate together :tada:" +author: +- Luke W. Johnston +date: "2025-12-16" +categories: + - workshop + - training + - github +--- + +Early in 2025 we received several requests at Steno Aarhus to run a +workshop on how to use GitHub for managing and working with files. Steno +Aarhus has been making increasing efforts to integrate use of GitHub +into the organisation overall and into individual research projects. But +many researchers and staff were still unfamiliar with how to use GitHub +effectively. So in early 2025, we started developing a [gentle +introduction workshop to using +GitHub](https://github-intro.rostools.org). + +We finished developing the material and ran the workshop on May 26th, +2025 in-person at Steno Aarhus for staff and researchers. We had 24 +participants register and attend the workshop, which we didn't expect to +be so high! The workshop was very well received, with very positive +feedback from participants (see below for some plots of the feedback). + +We are collaborating with the [DP-Next +project](https://dp-next.github.io/) to develop and build up their data +infrastructure, collection processes, and storage capacity. But we're +also aiming to build up the technical expertise of their members. So +when DP-Next officially started in September 2025, we planned to run the +workshop for their members as well. + +Since they are spread across all the Steno centers in Denmark, Faroe +Islands, and Greenland, we had to run the workshop online. However this +was the first time we've ever ran a workshop online, so we had to +investigate different options and ways for doing this effectively. We +ended up using [Gather](https://gather.town/) to virtually host the +workshop. + +So on September 9th, 2025, we ran the workshop online for DP-Next +members. We had 11 participants, who were a mix of PhD students and +postdocs from each of the Steno centers. As with the in-person workshop, +participants gave very positive feedback and especially enjoyed the +online platform. + +## Participant demographics + +To give some "harder" numbers, the figure below shows some basic +demographics about the participants of the two workshops. The first +workshop had a large majority of participants who identified as +"she/her" as well as different types of positions. + +::: column-page +![Some basic demographics of the participants who registered for the two +workshops.](overview.svg){#fig-demographics +fig-alt="A series of bar plots showing an overview of who the participants were, such as their preferred pronoun and their position."} +::: + +## Quantitative feedback + +While we collect anonymous [qualitative +feedback](https://github.com/rostools/samwise/tree/main/inst/extdata/surveys/gh_intro) +from participants after each workshop from a short survey, we also +collect quantitative feedback. We have a series of statements that +participants respond to on a Likert-scale, from "Strongly disagree" to +"Strongly agree". The two plots below show the quantitative feedback +from participants of both the in-person and online workshops. Overall, +the feedback was very positive, with the vast majority of participants +agreeing or strongly agreeing with the statements provided. + +:::: column-page +::: {#fig-feedback layout-ncol="1"} +![May 26th in-person workshop.](feedback-2025-05-26.svg){#fig-in-person +fig-alt="A series of bar plots showing the quantitative feedback from participants of the May 26th workshop, with each plot showing the statement above the plot and the responses as the bars."} + +![September 9th virtual workshop.](feedback-2025-09-09.svg){#fig-virtual +fig-alt="A series of bar plots showing the quantitative feedback from participants of the September 9th virtual workshop, with each plot showing the statement above the plot and the responses as the bars."} + +Quantitative feedback from participants of the two workshops. +::: +:::: + +## Next steps + +We will probably run this workshop again next year, but we also want to +develop and run a workshop on how to collaborate effectively as a team +using GitHub, which we've [already +started](https://github.com/rostools/git4cats) working on. We're quite +excited about that one as we think a lot of people could benefit from +learning more effective practices at collaborating and developing +something together. We hope to run that workshop in mid-2026 :tada: diff --git a/posts/workshop-github-intro/overview.svg b/posts/workshop-github-intro/overview.svg new file mode 100644 index 0000000..7d3edd1 --- /dev/null +++ b/posts/workshop-github-intro/overview.svg @@ -0,0 +1,232 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +2025-05-26 + + + + + + + + + +2025-09-09 + + + + + + + + + +Formal +position + + + + + + + + + +Preferred +pronoun + + +0 +5 +10 +15 +0 +2 +4 +6 +Consultant +Data manager +Masters student +PhD student +Pojectleader +Postdoc +Project secretary +Research assistant +Research program lead +Research project coordinator +Researcher +Student assistant +He/him +She/her +Consultant +Data manager +Masters student +PhD student +Pojectleader +Postdoc +Project secretary +Research assistant +Research program lead +Research project coordinator +Researcher +Student assistant +He/him +She/her +Number of responses + + + From f4deb64f4f400e78b29348e1aee3db58233f460b Mon Sep 17 00:00:00 2001 From: "Luke W. Johnston" Date: Fri, 19 Dec 2025 16:13:08 +0100 Subject: [PATCH 2/7] fix: :pencil2: edits from review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Signe Kirk Brødbæk --- posts/workshop-github-intro/index.qmd | 34 +++++++++++++-------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/posts/workshop-github-intro/index.qmd b/posts/workshop-github-intro/index.qmd index 44d32be..5d77db5 100644 --- a/posts/workshop-github-intro/index.qmd +++ b/posts/workshop-github-intro/index.qmd @@ -1,6 +1,6 @@ --- -title: "Developed and ran a new workshop on how to use GitHub" -description: "We received several requests for running a workshop on using GitHub from collaborators and colleagues. So we developed a gentle introduction to using GitHub as part of our efforts to build up digitally technical capacity and upskill researchers to more effectively collaborate together :tada:" +title: "Developed and ran a new GitHub intro workshop" +description: "After receiving several requests, we developed a workshop with a gentle GitHub introduction to help build digital technical capacity and support more effective research collaboration." author: - Luke W. Johnston date: "2025-12-16" @@ -10,47 +10,47 @@ categories: - github --- -Early in 2025 we received several requests at Steno Aarhus to run a +Early in 2025 we received several requests at Steno Aarhus from colleagues and collaborators to run a workshop on how to use GitHub for managing and working with files. Steno Aarhus has been making increasing efforts to integrate use of GitHub into the organisation overall and into individual research projects. But -many researchers and staff were still unfamiliar with how to use GitHub +many researchers and staff are still unfamiliar with how to use GitHub effectively. So in early 2025, we started developing a [gentle -introduction workshop to using +introductory workshop to using GitHub](https://github-intro.rostools.org). We finished developing the material and ran the workshop on May 26th, 2025 in-person at Steno Aarhus for staff and researchers. We had 24 -participants register and attend the workshop, which we didn't expect to -be so high! The workshop was very well received, with very positive +participants attend the workshop, which were more people than we +anticipated! The workshop was very well received, with very positive feedback from participants (see below for some plots of the feedback). We are collaborating with the [DP-Next project](https://dp-next.github.io/) to develop and build up their data infrastructure, collection processes, and storage capacity. But we're -also aiming to build up the technical expertise of their members. So +also aiming to build up the technical expertise of people in the group. So when DP-Next officially started in September 2025, we planned to run the workshop for their members as well. Since they are spread across all the Steno centers in Denmark, Faroe -Islands, and Greenland, we had to run the workshop online. However this +Islands, and Greenland, we ran the workshop online. This was the first time we've ever ran a workshop online, so we had to investigate different options and ways for doing this effectively. We ended up using [Gather](https://gather.town/) to virtually host the workshop. -So on September 9th, 2025, we ran the workshop online for DP-Next +On September 9th, 2025, we ran the workshop online for the DP-Next members. We had 11 participants, who were a mix of PhD students and postdocs from each of the Steno centers. As with the in-person workshop, -participants gave very positive feedback and especially enjoyed the +participants gave very positive feedback and they also enjoyed the online platform. ## Participant demographics -To give some "harder" numbers, the figure below shows some basic +The figure below shows some basic demographics about the participants of the two workshops. The first -workshop had a large majority of participants who identified as -"she/her" as well as different types of positions. +workshop most participants used +she/her pronouns with diverse formal positions. In the second workshop, the pronoun distribution of she/her and he/him were more even with almost half of the participants being PhD students. No participants preferred other pronouns to she/her and he/him. ::: column-page ![Some basic demographics of the participants who registered for the two @@ -62,7 +62,7 @@ fig-alt="A series of bar plots showing an overview of who the participants were, While we collect anonymous [qualitative feedback](https://github.com/rostools/samwise/tree/main/inst/extdata/surveys/gh_intro) -from participants after each workshop from a short survey, we also +via free-form text in the surveys from participants after each workshop, we also collect quantitative feedback. We have a series of statements that participants respond to on a Likert-scale, from "Strongly disagree" to "Strongly agree". The two plots below show the quantitative feedback @@ -73,10 +73,10 @@ agreeing or strongly agreeing with the statements provided. :::: column-page ::: {#fig-feedback layout-ncol="1"} ![May 26th in-person workshop.](feedback-2025-05-26.svg){#fig-in-person -fig-alt="A series of bar plots showing the quantitative feedback from participants of the May 26th workshop, with each plot showing the statement above the plot and the responses as the bars."} +fig-alt="Bar plots showing the quantitative feedback from participants in the May 26 workshop, with each plot showing the responses to a single question."} ![September 9th virtual workshop.](feedback-2025-09-09.svg){#fig-virtual -fig-alt="A series of bar plots showing the quantitative feedback from participants of the September 9th virtual workshop, with each plot showing the statement above the plot and the responses as the bars."} +fig-alt="Bar plots showing the quantitative feedback from participants of the September 9 virtual workshop, with each plot showing the responses to a single question."} Quantitative feedback from participants of the two workshops. ::: From 9aa493a4d21d612d2b7476740ececfdab0ba3205 Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Fri, 19 Dec 2025 15:13:25 +0000 Subject: [PATCH 3/7] chore(pre-commit): :pencil2: automatic fixes --- posts/workshop-github-intro/index.qmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/posts/workshop-github-intro/index.qmd b/posts/workshop-github-intro/index.qmd index 5d77db5..ff79f3a 100644 --- a/posts/workshop-github-intro/index.qmd +++ b/posts/workshop-github-intro/index.qmd @@ -50,7 +50,7 @@ online platform. The figure below shows some basic demographics about the participants of the two workshops. The first workshop most participants used -she/her pronouns with diverse formal positions. In the second workshop, the pronoun distribution of she/her and he/him were more even with almost half of the participants being PhD students. No participants preferred other pronouns to she/her and he/him. +she/her pronouns with diverse formal positions. In the second workshop, the pronoun distribution of she/her and he/him were more even with almost half of the participants being PhD students. No participants preferred other pronouns to she/her and he/him. ::: column-page ![Some basic demographics of the participants who registered for the two From a21ec7ad6400cea7aab7597eb7e049239cda1f25 Mon Sep 17 00:00:00 2001 From: "Luke W. Johnston" Date: Fri, 19 Dec 2025 16:19:43 +0100 Subject: [PATCH 4/7] style: :art: reformat Markdown --- posts/workshop-github-intro/index.qmd | 47 ++++++++++++++------------- 1 file changed, 24 insertions(+), 23 deletions(-) diff --git a/posts/workshop-github-intro/index.qmd b/posts/workshop-github-intro/index.qmd index ff79f3a..e1dd554 100644 --- a/posts/workshop-github-intro/index.qmd +++ b/posts/workshop-github-intro/index.qmd @@ -10,13 +10,13 @@ categories: - github --- -Early in 2025 we received several requests at Steno Aarhus from colleagues and collaborators to run a -workshop on how to use GitHub for managing and working with files. Steno -Aarhus has been making increasing efforts to integrate use of GitHub -into the organisation overall and into individual research projects. But -many researchers and staff are still unfamiliar with how to use GitHub -effectively. So in early 2025, we started developing a [gentle -introductory workshop to using +Early in 2025 we received several requests at Steno Aarhus from +colleagues and collaborators to run a workshop on how to use GitHub for +managing and working with files. Steno Aarhus has been making increasing +efforts to integrate use of GitHub into the organisation overall and +into individual research projects. But many researchers and staff are +still unfamiliar with how to use GitHub effectively. So in early 2025, +we started developing a [gentle introductory workshop to using GitHub](https://github-intro.rostools.org). We finished developing the material and ran the workshop on May 26th, @@ -28,16 +28,15 @@ feedback from participants (see below for some plots of the feedback). We are collaborating with the [DP-Next project](https://dp-next.github.io/) to develop and build up their data infrastructure, collection processes, and storage capacity. But we're -also aiming to build up the technical expertise of people in the group. So -when DP-Next officially started in September 2025, we planned to run the -workshop for their members as well. +also aiming to build up the technical expertise of people in the group. +So when DP-Next officially started in September 2025, we planned to run +the workshop for their members as well. Since they are spread across all the Steno centers in Denmark, Faroe -Islands, and Greenland, we ran the workshop online. This -was the first time we've ever ran a workshop online, so we had to -investigate different options and ways for doing this effectively. We -ended up using [Gather](https://gather.town/) to virtually host the -workshop. +Islands, and Greenland, we ran the workshop online. This was the first +time we've ever ran a workshop online, so we had to investigate +different options and ways for doing this effectively. We ended up using +[Gather](https://gather.town/) to virtually host the workshop. On September 9th, 2025, we ran the workshop online for the DP-Next members. We had 11 participants, who were a mix of PhD students and @@ -47,10 +46,12 @@ online platform. ## Participant demographics -The figure below shows some basic -demographics about the participants of the two workshops. The first -workshop most participants used -she/her pronouns with diverse formal positions. In the second workshop, the pronoun distribution of she/her and he/him were more even with almost half of the participants being PhD students. No participants preferred other pronouns to she/her and he/him. +The figure below shows some basic demographics about the participants of +the two workshops. The first workshop most participants used she/her +pronouns with diverse formal positions. In the second workshop, the +pronoun distribution of she/her and he/him were more even with almost +half of the participants being PhD students. No participants preferred +other pronouns to she/her and he/him. ::: column-page ![Some basic demographics of the participants who registered for the two @@ -62,10 +63,10 @@ fig-alt="A series of bar plots showing an overview of who the participants were, While we collect anonymous [qualitative feedback](https://github.com/rostools/samwise/tree/main/inst/extdata/surveys/gh_intro) -via free-form text in the surveys from participants after each workshop, we also -collect quantitative feedback. We have a series of statements that -participants respond to on a Likert-scale, from "Strongly disagree" to -"Strongly agree". The two plots below show the quantitative feedback +via free-form text in the surveys from participants after each workshop, +we also collect quantitative feedback. We have a series of statements +that participants respond to on a Likert-scale, from "Strongly disagree" +to "Strongly agree". The two plots below show the quantitative feedback from participants of both the in-person and online workshops. Overall, the feedback was very positive, with the vast majority of participants agreeing or strongly agreeing with the statements provided. From c0c03f2f8b025386a7542f1168304ad00c28a129 Mon Sep 17 00:00:00 2001 From: "Luke W. Johnston" Date: Fri, 19 Dec 2025 16:20:10 +0100 Subject: [PATCH 5/7] style: :lipstick: don't use axes labels between plots --- posts/workshop-github-intro/create-plots.R | 11 +- .../feedback-2025-05-26.svg | 512 +++++++++--------- .../feedback-2025-09-09.svg | 424 +++++++-------- posts/workshop-github-intro/overview.svg | 326 ++++++----- 4 files changed, 631 insertions(+), 642 deletions(-) diff --git a/posts/workshop-github-intro/create-plots.R b/posts/workshop-github-intro/create-plots.R index 0e591a7..c940273 100644 --- a/posts/workshop-github-intro/create-plots.R +++ b/posts/workshop-github-intro/create-plots.R @@ -1,6 +1,6 @@ # pak::pak("rostools/samwise", ask = FALSE) -library(tidyverse) +library(tidyverse, quietly = TRUE) library(samwise) overview <- read_surveys("gh_intro", "overview") @@ -15,7 +15,6 @@ plot_overview_community <- function(data) { rows = vars(question), scales = "free", space = "free_y", - axes = "all_y", labeller = ggplot2::label_wrap_gen(width = 10) ) + theme( @@ -27,7 +26,9 @@ save_plot_feedback <- function(data) { ggsave( filename = glue::glue("feedback-{unique(data$date)}.svg"), plot = plot_feedback(data) + - scale_x_continuous(breaks = seq(0, 12, by = 2)) + scale_x_continuous(breaks = seq(0, 12, by = 2)), + width = 12, + height = 6 ) } @@ -42,7 +43,9 @@ feedback |> ggsave( filename = "overview.svg", - plot = plot_overview_community(overview) + plot = plot_overview_community(overview), + width = 12, + height = 6 ) feedback |> diff --git a/posts/workshop-github-intro/feedback-2025-05-26.svg b/posts/workshop-github-intro/feedback-2025-05-26.svg index 698a644..4897f4a 100644 --- a/posts/workshop-github-intro/feedback-2025-05-26.svg +++ b/posts/workshop-github-intro/feedback-2025-05-26.svg @@ -1,5 +1,5 @@ - +