port page improvements back to template; closes #76

content/_index.md

@@ -41,17 +41,17 @@ We collect here the exercise groups that we know:
 - ...
 
 
-## Recording and broadcasting
+## Outreach
 
 - ...
 
 
-## Outreach
+## Recording and broadcasting
 
 - ...
 
 
-## Expert helpers
+## Local organizers
 
 - ...
 

content/certificates.md

@@ -14,13 +14,14 @@ registered in Aalto systems.  Please note that this does not apply to
 participants affiliated with TU Delft or other universities who have own
 criteria for workshop certificates and credits.
 
-To obtain a certificate, we expect you to **follow the 6 days** of the course and
-provide us with the following **three documents via email**:
+To obtain a certificate, you must be affiliated with a university, or similar
+research organisation. We expect you to **follow the 6 days** of the course and
+provide us with the following **three text documents sent from your university email**:
 
-1. The output of `git log --all` from the repositories that you have used
-   during the course as a text file. Evaluation criteria: we expect to see the
-   results from most of the git commands that are run in the first 3 days of
-   the workshop.
+1. A document that shows that you did the exercises during the course. *Note: if you are planning to delete the exercise repository from your GitHub projects, instead of sending links to your work you can send PDF screenshots e.g. by doing "print to PDF" with your browser.*
+   - Write one or more paragraphs about [Day 1 - Exercise 2](https://coderefinery.github.io/git-intro/commits/#exercise): provide the link to the forked repository on your GitHub account and show that you did new commits. If you did not use GitHub and if you used the command line, then provide the output of the command `git log --all` for the forked repository. Explain what you did. 
+   - Write one or more paragraphs about [Day 2 - Exercise 3](https://coderefinery.github.io/git-intro/sharing/#exercise): provide the link to the new repository you have created on your GitHub account. If you did not use GitHub and if you used the command line, then provide the output of the command `git log --all` for the newly created repository. Explain what you did.
+   - Write one or more paragraphs about [Day 3 - Exercise 1](https://coderefinery.github.io/git-collaborative/same-repository/#exercise): provide the link to the pull request. Explain what you did.
 2. Written answers to the following four questions submitted as a document (pdf
    or word or txt). Evaluation criteria: we expect critical answers related to
    the content of first 3 days with both pros and cons (when relevant):
@@ -36,3 +37,5 @@ provide us with the following **three documents via email**:
 
 During the workshop we will provide with contact addresses where you should
 send these documents to.
+
+As this is a very simple homework, the use of generative AI (like ChatGPT) is not allowed. We also have access to ChatGPT and we know how to write prompts that can generate the answers to these homework, so it is very easy for us to check when AI was used. Submissions suspected of being generated by AI will be rejected.

content/communication/2024-03-01-team-leaders-without-groups.md

@@ -0,0 +1,27 @@
++++
+title = "2024-03-01 Practical info for team leaders without own groups"
+[extra]
+subject = "CodeRefinery workshop: practical info for team leaders"
++++
+
+Dear all,
+
+You have indicated that you might want to help out as team leader but don't have a team yet.
+Thank you for your interest in helping the CodeRefinery to become an educational experience for everyone!
+
+This time, we do not provide a central exercise Zoom for learners and team leaders without own groups.
+However, you can still support the workshop and here are few options:
+
+- Be available for questions. During the workshop we will use a collaborative document for asynchronous Q&A, you can help by answering questions there and keeping things organized.
+- Gather colleagues and organize a (virtual) room to watch the workshop stream together and discuss the exercises of week 1. You can also organize additional exercise or help sessions around the workshop.
+- Advertise the workshop in your networks. Let us know if we can help by providing texts or so.
+
+In any case you are welcome to attend our team leader onboarding session, to get to know about the different options:
+- Zoom link: (URL)
+- Schedule: https://coderefinery.github.io/2024-03-12-workshop/#schedule
+
+If you have any questions, please write to me or [email protected].
+
+Thank you,
+
+Radovan and the CodeRefinery team

content/communication/2024-03-01-team-leaders.md

@@ -0,0 +1,69 @@
++++
+title = "2024-03-01 Practical info for team leaders and local organizers"
+[extra]
+subject = "CodeRefinery workshop: practical info for team leaders and local organizers"
++++
+
+Dear all,
+
+
+**Summary**
+
+Thanks for being a team leader/ local organizer! 
+
+Please join one of our onboarding sessions about being a team leader:
+- Zoom link: (URL)
+- Schedule: https://coderefinery.github.io/2024-03-12-workshop/#schedule
+
+We are working on simplifying install instructions (please wait with those).
+
+We plan to send an email to all registrants next week Tuesday.
+
+The are currently reworking the Git lessons for week 1 to reflect more how people work with Git today. 
+
+
+**Thank you**
+
+First of all: Thanks so much for doing this! It's the teams and team leaders that make this workshop really work. We really appreciate!
+
+
+**What to expect**
+
+Expect a dynamic, exciting first week with lots of hands-on activities. Week 2 will be calmer, as we try a new route, providing exercise walk-throughs on stream and leaving it up to groups and individuals to play around on their own time. We suggest to meet in teams for week 1. If your group prefers to go through week 2 exercises, then we recommend to schedule your own sessions for that.
+
+
+**How to prepare to lead a team**
+
+Some hints on being a team leader
+
+Do you want to be active or to be around?
+
+- If active: You'll need to take the lead in discussions. You don't have to discuss the active material: you could make the discussions about your own work (our material will be there later anyway).
+- If "be around": During exercise sessions and other times, you can ask how it's going and take questions there. If it's too quiet, ask someone to screen-share and everyone else to say what to do.
+
+Be kind and considerate to everyone. Not everyone has to learn or do the same things. Don't make people feel bad for not doing as much as others, it's only natural!
+
+Don't worry! Take the first day to see how it works and then adapt based on what your group would like.
+
+It can be very hard to get people to talk sometimes. You can try this: Ask someone to screen-share (or you can). The person screen-sharing doesn't figure out what to do, but others tell them what to do. You can even make any exercises group-based this way.
+
+If you meet in-person and have a large screen to share: Twitch stream on one half, Notes on the other half.
+
+
+**Onboarding session**
+
+We provide 4 sessions for onboarding of team leaders next week. Please join one of them to learn about the workshop format and ask any questions you may have. The zoom link is the on top of the email.
+
+
+**Materials to read**
+
+One-page summary with tips and tricks: https://coderefinery.github.io/manuals/team-leaders/
+
+
+**Questions?**
+
+If you have any questions, please write to [email protected].
+
+Thank you,
+
+Radovan and the CodeRefinery team

content/communication/2024-03-05-practical-info.md

@@ -0,0 +1,40 @@
++++
+title = "2024-03-05 Practical information one week before the workshop"
+[extra]
+subject = "[CodeRefinery workshop] practical information"
++++
+
+Dear {first_name},
+
+We are one week away from the CodeRefinery workshop. Exciting!
+
+Everybody, please install required software before the workshop (we made it a lot easier this time):
+- https://coderefinery.github.io/installation/
+- We offer two install help sessions (today and in two days; Tue and Thu): (URL shared with registrants)
+- Schedule in your time zone: https://coderefinery.github.io/2024-03-12-workshop/#schedule
+
+If you are a team leader or organize a local classroom, please come to one of our on-boarding sessions:
+- https://coderefinery.github.io/2024-03-12-workshop/#schedule
+- Zoom link for on-boarding sessions: (URL shared with registrants)
+
+
+**For all workshop participants**, here are all relevant resources that you need to connect:
+
+You can follow the workshop lectures via Twitch in a web browser, no account needed:
+- https://twitch.tv/coderefinery
+
+Please use this collaborative document to ask questions during the workshop:
+- (URL shared with registrants)
+
+Schedule and lecture material:
+- https://coderefinery.github.io/2024-03-12-workshop/#schedule
+- Each day we will take a break for lunch, which we have done our best to schedule at a time that will work for most locations as we are across multiple time zones.
+- We are still working on updating the Git lessons. This time we plan to work more in the browser and editor and less in the terminal.
+
+
+If you have any questions, please write to [email protected] or reply to me.
+
+
+Best regards,
+
+Radovan and the CodeRefinery team

content/communication/2024-03-10-practical-info2.md

@@ -0,0 +1,31 @@
++++
+title = "2024-03-10 Practical information one day before the workshop"
+[extra]
+subject = "[CodeRefinery workshop] practical information"
++++
+
+Dear {first_name},
+
+The CodeRefinery workshop starts on Tuesday!
+
+We expect a dynamic and exciting workshop and very much look forward to it.
+Below are all relevant resources that you need to connect.
+
+You can follow the workshop lectures via Twitch in a web browser, no account needed:
+- https://twitch.tv/coderefinery
+
+Please use this collaborative document to ask questions during the workshop:
+- (URL shared with registrants)
+
+Schedule and lecture material:
+- https://coderefinery.github.io/2024-03-12-workshop/#schedule (in your local time zone)
+- Each day we will take a break for lunch, which we have done our best to schedule at a time that will work for most locations as we are across multiple time zones.
+
+Please install required software before the workshop:
+- https://coderefinery.github.io/installation/
+
+If you have any questions, please write to [email protected] or reply to me.
+
+Best regards,
+
+Radovan and the CodeRefinery team

content/communication/2024-03-12-exercise-preparation.md

@@ -0,0 +1,24 @@
++++
+title = "2024-03-12 Exercise preparation for learners without own group"
+[extra]
+subject = "[CodeRefinery workshop] preparation for Thursday for leaners without own group"
++++
+
+Dear {first_name},
+
+This email is only relevant if you plan to participate in the CodeRefinery workshop this Thursday as individual learner and are not part of a team or a local exercise group.
+
+On Thursday we will all practice how to collaborate using Git/GitHub and one ambitious thing we will try is to collaborate with participants following via stream.
+
+If you would like to participate as individual learner in the collaborative exercises, please request access by opening an issue at https://github.com/cr-workshop-exercises/access-requests/issues/new/choose (There click "Get started" -> "Submit new issue")
+
+This way we will know your GitHub username and give you write access to exercise repositories.
+
+After we add you as collaborator, you will get an email from GitHub.
+- Please accept the invitation
+- Don't forget to "unwatch" both https://github.com/cr-workshop-exercises/centralized-workflow-exercise and https://github.com/cr-workshop-exercises/centralized-workflow-exercise-recorded to make sure you don't get too many emails during the exercise.
+- To "unwatch", go to the repository and click the "Unwatch" button (top middle of the screen) and then select "Participating and @mentions".
+
+Best regards,
+
+Radovan and the CodeRefinery team

content/communication/2024-03-18-week2-prep.md

@@ -0,0 +1,36 @@
++++
+title = "2024-03-18 Welcome to week 2"
+[extra]
+subject = "[CodeRefinery workshop] welcome to week 2"
++++
+
+Dear {first_name},
+
+Thank you for joining the workshop last week, and for all the wonderful questions we got from you!
+For those who join us now for the second week only, welcome!
+- All questions and answers are archived: https://coderefinery.github.io/2024-03-12-workshop/questions/
+- Video recordings are published: https://www.youtube.com/watch?v=9eUUd40HkYI&list=PLpLblYHCzJADIsbUhXSrC0qW5wDsH-F9U
+
+We hope you got some good practice and understanding on how to collaborate using Git/GitHub and our trial of collaborating with you from the stream worked out for you! If you have suggestions on how to improve our lessons, please open issues or send pull requests:
+- https://github.com/coderefinery/git-intro
+- https://github.com/coderefinery/git-collaborative
+
+
+This week will be a little more diverse!
+
+We will take a peek into six topics that are all related to FAIR research software development:
+
+Tuesday will start with an overview of how all CodeRefinery lessons fit together under the umbrella of reproducible research and what steps you can take now already to make your research more reproducible. In the afternoon we will look into licenses, how they work and why you might want to care even when "only writing a small script for myself".
+
+Wednesday morning we look at different ways of how to document research code. From small projects with good README files to external documentation on Read the Docs. In the afternoon we will show some tips and tricks around Jupyter notebooks and how they can be used also outside of courses.
+
+Thursday we step a little deeper into software development practices by giving you an introduction into automated testing and how this could benefit you and your collaborators. The workshop ends with some live coding to showcase how to make code more reusable by caring about modularity.
+
+In contrast to week 1, there will not be any dedicated exercise times in week 2. Instead, instructors will demo things and discuss with you using the collaborative document. If you want, you can of course try to follow the demos or try to do them on your own time after the workshop. For this, you will need to install some tools which you can find at: https://coderefinery.github.io/installation/.
+
+We hope to see you again this week with the first session starting Tuesday at 9:00 CET (10 EET). We will start the stream 10 minutes earlier: https://coderefinery.github.io/2024-03-12-workshop/#schedule
+
+
+Best regards,
+
+CodeRefinery team

content/communication/announcement-long.md

@@ -1,14 +1,14 @@
 +++
 title = "Workshop announcement example (longer version)"
 [extra]
-subject = "CodeRefinery Workshop announcement"
+subject = "CodeRefinery workshop announcement"
 +++
 
 Are you writing code and managing data for your research? Do you feel like
 wasting too much time on manual work? Do you struggle to understand and reuse older code?
 
 Join
-the CodeRefinery workshop
+the CodeRefinery workshop,
 **ADAPT DATES**,
 for free and online.
 

content/communication/announcement-short.md

@@ -1,12 +1,12 @@
 +++
 title = "Workshop announcement example (shorter version)"
 [extra]
-subject = "CodeRefinery Workshop announcement"
+subject = "CodeRefinery workshop announcement"
 +++
 
 CodeRefinery invites everyone interested in improving their software practice
 skills to join
-the CodeRefinery workshop
+the CodeRefinery workshop,
 **ADAPT DATES**,
 for free and online.