From 33635824475fc66e84d2205c13d8ad19658fb517 Mon Sep 17 00:00:00 2001 From: Mathew Biddle <8480023+MathewBiddle@users.noreply.github.com> Date: Fri, 10 May 2024 16:41:14 -0400 Subject: [PATCH] making participant guide for 2024 --- _config.yml | 7 +- _includes/header.html | 5 + .../2022-04-25-event-checklist.md | 0 .../2022-04-25-participant-guide.md | 1 + _resources/2024-05-01-participant-guide.md | 92 +++++++++++++++++++ .../templates/project-email.md | 0 .../templates/project-lead-spreadsheet.md | 0 .../templates/shared-documents.md | 0 .../templates/slack-workspace.md | 0 resources.md | 7 +- resources/templates.md | 42 --------- 11 files changed, 106 insertions(+), 48 deletions(-) rename resources/event-checklist.md => _resources/2022-04-25-event-checklist.md (100%) rename resources/participant-guide.md => _resources/2022-04-25-participant-guide.md (99%) create mode 100644 _resources/2024-05-01-participant-guide.md rename {resources => _resources}/templates/project-email.md (100%) rename {resources => _resources}/templates/project-lead-spreadsheet.md (100%) rename {resources => _resources}/templates/shared-documents.md (100%) rename {resources => _resources}/templates/slack-workspace.md (100%) delete mode 100644 resources/templates.md diff --git a/_config.yml b/_config.yml index 2209604..3ca8c9c 100644 --- a/_config.yml +++ b/_config.yml @@ -20,7 +20,7 @@ header_pages: - agenda.md # - topics.md - videos-slides.md - - resources.md +# - _resources.md - about.md # Open and close the registration form @@ -28,7 +28,7 @@ header_pages: # open = Registration form is open # closed = Registration form is now closed registration_status_2022: closed -registration_status_2024: open +registration_status_2024: closed # Remove ".html" from default permalinks permalink: pretty @@ -50,6 +50,9 @@ collections: abouts: output: true permalink: :year/:title:output_ext + resources: + output: true + permalink: :year/:title:output_ext future: true # Social media links diff --git a/_includes/header.html b/_includes/header.html index f5dd032..8dddc41 100644 --- a/_includes/header.html +++ b/_includes/header.html @@ -39,6 +39,11 @@ {{ page.year }} About + + + {{ page.year }} Participant Guide + + diff --git a/resources/event-checklist.md b/_resources/2022-04-25-event-checklist.md similarity index 100% rename from resources/event-checklist.md rename to _resources/2022-04-25-event-checklist.md diff --git a/resources/participant-guide.md b/_resources/2022-04-25-participant-guide.md similarity index 99% rename from resources/participant-guide.md rename to _resources/2022-04-25-participant-guide.md index b9ce701..a4a5c7e 100644 --- a/resources/participant-guide.md +++ b/_resources/2022-04-25-participant-guide.md @@ -1,6 +1,7 @@ --- title: Participant guide layout: resource +year: 2022 ---
diff --git a/_resources/2024-05-01-participant-guide.md b/_resources/2024-05-01-participant-guide.md new file mode 100644 index 0000000..f900e70 --- /dev/null +++ b/_resources/2024-05-01-participant-guide.md @@ -0,0 +1,92 @@ +--- +title: Participant guide +layout: page +year: 2024 +--- + +
+# Welcome to the IOOS Code Sprint + +**We're glad you're here!** + +This guide explains how the code sprint is being organized, from how we will be +communicating, what activities we envisage you will undertake, how we suggest +you access data and store your code/outputs. +
+ +## Overview +{:.no_toc} + +In this guide we'll cover: + +* Table of contents +{:toc} + +
+We recommend that when you first sit down with your group, someone volunteers to serve as the **chair** for your topic. +This person should be responsible for: +* Ensuring that the group works to the suggested agenda. +* The group is ready to present their work during their presentation slot(s). +* The code/outputs are well organized. +This is an excellent way of getting some team management experience and so we emphasize that this person does not need to be somebody who is already leading a topic. +* Updating the `#code-sprint-2024` channel every 45 minutes with a short update on your track's activity. Make sure to `#tag` your topic's channel. + +
+ +## How our event is structured +The event is a hybrid format with attendees both in-person at The Wharf, and vitrual connecting through Zoom and Slack. + +### For virtual attendees +Before the week of the Code Sprint, you will receive a link to a Google Calendar for the Code Sprint events. Below is a description of how each of those events relates to the Code Sprint as a whole. + +**MAIN ROOM** - This will be the virtual connection to the parts of the agenda that are for the entire Code Sprint audience (Introductions, Daily kickoff, and Daily recap). + +**[track]** - There are individual Zoom breakout rooms for each of the Tracks listed [here](https://github.com/ioos/ioos-code-sprint/blob/main/2024/track-list.md). This is where participants will be spending the majority of their time. These spaces will be available for you to connect to during the break group portions of the event. You can enter and exit the sprint track rooms as you wish. + +### For in-peron attendees + +* Make sure the room you are in has a connection to the appropriate Zoom breakout room for virtual attendees. +* Make an announcement on the `#code-sprint-2024` channel, identifying the topic to be worked on and the Zoom breakout room information. +* Check the [agenda]({{ site.baseurl }}/2024/agenda) or the `#code-sprint-2024` channel on Slack for more detailed information. + +## How we are communicating + +We are using: +* **Zoom** for the talks and breakout groups. All participants will be invited to all the meetings so virtual attendees can easily move between them as needed. +* **Slack** for text-based chat, sharing of ideas, announcements and technical support (we have a channel for each project group, plus the main #code-sprint-2024 channel. +* **[Resources]({{ site.baseurl }}{% link resources.md %})** will be where any slides, or resources can be linked for reference during the event of afterwards (this page will live on!). +* **[Topic]({{ site.baseurl }}{% link topics.md %})** pages will fill out as the sprint progresses. Anyone can submit a change to these pages. + +## How we are storing code, data and outputs + +Each project should have: + +* A **GitHub repository**, which you can use to share you code and the outcomes + of your work + +
+We ask that by the end of the code sprint: + +1. Your project's GitHub repository has a **README** file (or GitHub issue), identifying what work + you did, how far you got and what the next steps required are +2. You identify one (or more) **key figures/outcomes** that could be showcased at the + Annual DMAC meeting. +
+ +## Where to go for help + +
+The best way to contact us during the code sprint is to use the channel `#code-sprint-2024` on Slack. +
+ +### A note on bandwidth at the event + +For those attending in-person, at The Wharf, we will be using the wifi network provided. If you need high bandwidth to download large amounts of data for your project we recommend using cloud services, preload on local machine, or bring usb sticks. If you have special circumstances or questions, please post your requirements to the `#code-sprint-2024` Slack channel and we can see how we can accomodate your needs. + +## Feedback + +We really appreciate your feedback on this code sprint, in the hope that we can improve future events for yourself and others. Near the end of the code sprint we will send round a link to a feedback form for you to complete. + +## Questions? + +Email (or Slack) Matt Biddle (mathew.biddle@noaa.gov)! diff --git a/resources/templates/project-email.md b/_resources/templates/project-email.md similarity index 100% rename from resources/templates/project-email.md rename to _resources/templates/project-email.md diff --git a/resources/templates/project-lead-spreadsheet.md b/_resources/templates/project-lead-spreadsheet.md similarity index 100% rename from resources/templates/project-lead-spreadsheet.md rename to _resources/templates/project-lead-spreadsheet.md diff --git a/resources/templates/shared-documents.md b/_resources/templates/shared-documents.md similarity index 100% rename from resources/templates/shared-documents.md rename to _resources/templates/shared-documents.md diff --git a/resources/templates/slack-workspace.md b/_resources/templates/slack-workspace.md similarity index 100% rename from resources/templates/slack-workspace.md rename to _resources/templates/slack-workspace.md diff --git a/resources.md b/resources.md index 5cbb55c..44ab84b 100644 --- a/resources.md +++ b/resources.md @@ -1,5 +1,5 @@ --- -title: Code Sprint resources +title: Code Sprint _resources menu_title: Resources menu_icon: journal-code --- @@ -8,7 +8,7 @@ menu_icon: journal-code
  • ## Getting set up -#### [Participant guide]({{ site.baseurl }}{% link resources/participant-guide.md %}) - a guide that explains how the code sprint is being organised +#### [Participant guide]({{ site.baseurl }}/resources/2022/participant-guide.html) - a guide that explains how the code sprint is being organised
  • @@ -20,7 +20,7 @@ menu_icon: journal-code
  • ## Help for organisers -#### [Event checklist]({{ site.baseurl }}{% link resources/event-checklist.md %}) – a checklist for activities required in the run-up to a hackathon event +#### [Event checklist]({{ site.baseurl }}//resources/2022/event-checklist.html) – a checklist for activities required in the run-up to a hackathon event An at-a-glace guide to the key activities required when organising a hackathon, including links to relevant resources and templates. @@ -29,7 +29,6 @@ hackathon, including links to relevant resources and templates.
  • ## Useful templates -#### [Templates]({{ site.baseurl }}{% link resources/templates.md %}) - useful forms, emails and resources for organisers
  • diff --git a/resources/templates.md b/resources/templates.md deleted file mode 100644 index 876a501..0000000 --- a/resources/templates.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: Template forms, emails and resources -layout: resource ---- - -
    -# Useful forms, emails and resources for organisers - -We hope that the following templates provide a useful starting point for similar -hackathons and events in the future. -
    - -## Table of contents -{:.no_toc} - -* Table of contents -{:toc} - -## Social media sharing images - -![Social media sharing image for the IOOS Code Sprint]({{ site.baseurl }}/assets/cs_graphic.png){: width="500" } - -## During the Code Sprint - -### Slack channel suggestions - - -[Open in a new page]({{ site.baseurl }}{% link resources/templates/slack-workspace.md %}) - -## After the Code Sprint - -Keep the activity going by continuing the conversation in Slack and contributing to the appropriate GitHub repository. - -### Feedback form - -