Online Collaboration Cafe¶
The Turing Way Collaboration Cafes (or ‘Cafés’ with an accent) are virtual co-working spaces that are held fortnightly on the first and third Wednesdays of each month for 2 hours. The schedule will be updated periodically on the GitHub page as per the community requirement.
We host these calls online using Zoom where we make use of the breakout rooms feature to allow small groups to use the 2 hours as best fits them. One or two members from the core team are always available on the call to support anyone wanting to learn more about collaborating on GitHub, getting a virtual tour of our GitHub repository or the book, and help you to make your first pull request (PR).
Attending an online Collaboration Cafe¶
The schedule for the collaboration cafe can be viewed from the community calendar. We also announce calls in our monthly newsletters, send a reminder on the Slack channel and Twitter.
Though scheduled for 2 hours, we understand that for many interested participants it might be impossible to commit to the entire 2 hours on one or multiple occasions, therefore, you are welcome to join for as long as your schedule allows.
If the current schedule of the online Collaboration Cafe is not suitable for your time zone, you are welcome to host a separate collaboration cafe for your community/time zone. Please open a new issue (see this example) or reach out to The Turing Way team members for details. We are also currently developing a guide for hosting these calls (issue #925).
Resources used for the call¶
Here are the resources we use for these calls:
Shared notes by HackMD: You can access these notes online at https://hackmd.io/@environmental-ai/BJXFYAw3_ and can take notes together with others on the call.
Online call by Zoom: The Zoom link is provided in the HackMD before the call, and members can click to join the call by opening zoom window on the web or by using the Zoom app that should be installed locally (available for free).
An online Pomodoro clock on Cuckoo.team: During the call, the clock is set for Pomodoro work intervals that can be live-tracked by everyone through their browsers.
We coordinate our tasks on the shared HackMD and/or The Turing Way GitHub repository, where we can work collaboratively or independently while working on an older GitHub issues/PRs, creating new issues/PRs, taking notes as comments on the GitHub repository or working on a branch locally.
Format of the call¶
We have a template for the Collaboration Cafes, which is updated on the shared HackMD for each call.
Schedule¶
We’ll run the following schedule during each Collaboration Cafe:
Duration |
Activity |
|---|---|
Start |
👋 Welcome, code of conduct review |
10 mins |
Introductions and personal goal setting |
20 mins |
🍅 1st Pomodoro session |
5 mins |
☕️ Break |
20 mins |
🍅 2nd Pomodoro session |
5 mins |
☕️ Break |
20 mins |
🍅 3rd Pomodoro session |
5 mins |
☕️ Break |
30 mins |
Open discussion: celebrations, reflections and future directions |
5 mins |
👋 Close |
Beginning¶
The call begins with the team members welcoming the participants, sharing the Code of Conduct, reminding how to participate in the call, and setting the stage for quick introductions by everyone.
Breaks¶
We will take short breaks after each Pomodoro to discuss what we are working on, ask questions that might help you in your next Pomodoro session, share any error or progress, and celebrate each others successes.
We will use the last 30 minutes for themed discussion, collaborative troubleshooting, or idea exchange for the project and community.
The welcome, introductions, breaks, and the open discussion will all happen in the main room.
Pomodoro sessions¶
Pomodoro sessions can happen either in the main zoom room in silence or in breakout rooms. We won’t record the Pomodoro parts of the Collaboration Cafe, nor conversations in the breakout rooms. You don’t need to know in advance what you’re going to do in those Pomodoro sessions! There will always be someone who can help you develop a goal, or allocate a task that you can do in a couple of rounds of 20 minutes.
If joining this call later¶
During a typical Pomodoro session, attendees are sent to breakout rooms based on the topic they are working on. If you join later, you will be able to check the remaining time in the ongoing Pomodoro by opening the shared clock in your browser (link should be provided in the shared notes). You can use that Pomodoro session to sign up, read notes from other attendees in the shared document, and explore what you would like to work on during the next Pomodoro session.
If you know in advance what time you will join the coworking call, you can let the host know before the call or leave a note in the shared document.
Recording this call¶
We may record the call for the part that involves open discussion so that others who can’t attend the call can learn from the conversations we have during the Collaboration Cafes. For this part, you do not have to speak or have your video on if you prefer not to be in the video. The videos will be uploaded to The Turing Way YouTube channel: https://www.youtube.com/channel/UCPDxZv5BMzAw0mPobCbMNuA.
Sign-up and icebreaker¶
If you’re interested in joining the next Collaboration Cafe, please let the organisers know by adding your name to the Sign Up section of the HackMD notes page. Adding your name is helpful for the organisers so they can prepare for the call. But don’t worry if you don’t sign up in advance. It’s ok to join at any time for as long as you’d like.
In addition to your names, we will encourage everyone to add a short response to an icebreaker question, that will help us all learn something personal about all the different people on the call.
Here are a few example questions (so you know what to expect):
what was your biggest achievement this week?
when was the last time you saw a rainbow?
what are you most excited about this year?
What is your favorite flavor in cake/ice-cream?
Do you have another interesting question to ask others? Get in touch and let us know! We love creative suggestions!
Here’s an example from the second Collaboration Cafe in September 2019:
Name + biggest achievement from this week + emoji that best explain your day (Remember that this is a public document. You can use a pseudonym if you’d prefer.)
Kirstie Whitaker + got a structure written out for an article that had been super hard to get started on! + 🤦♀️ (because I got these times mixed up - whoops!)
Malvika Sharan + Coming back from holiday, ready for exciting work :D + :grimacing:
As you can see, there’s a reminder in the notes that they are in a public document. It’s totally fine for you to add as much or as little information as you feel comfortable sharing.
Conversation starters¶
In the Conversation Starters section of the HackMD notes page, we encourage everyone to advertise their events or give an update from their community.
These don’t have to be Turing Way “branded”! We want to know about all the cool things you’re working on. ✨
Good first contributions¶
We want the Collaboration Cafes to be a place that welcomes new and old members to The Turing Way community.
In brainstorming these events, we imagined that some people may want to add new material that they’ve created before to the book, others may want to finish a contribution that they’ve started, and still others might want to learn new skills including how to contribute to The Turing Way. These are all great reasons to join us!
We’ll always have someone on the team available to help you brainstorm your first contribution, and answer any questions about how to incorporate your work.
Good first contributions might include:
Finding a typo in the book and/or repository and fixing it.
Looking for duplicated information in the book and opening an issue to discuss how it can be combined.
Finding an old issue or PR and try to summarize the discussion so it is easy to decide on the next step.
Adding your personal experience of reproducible research in the always open google form: https://goo.gl/forms/akFqZEIy2kxAjfZW2.
Breakout rooms¶
Zoom allows groups of collaborators to chat in one “main room” altogether, or to split up - within the same call - and talk with each other in smaller “breakout rooms”.
During the online Collaboration Cafe sessions, we’ll use the breakout rooms to allow people to talk about multiple different topics in parallel during the Pomodoro sessions.
You’ll see in the HackMD a section that says:
Breakout-rooms-Topic-proposals
If you have an idea for a topic you’d like to discuss in a breakout room, please add it below and put your name next to it. If you like one of the topics that are already suggested, please add your name next to that one. Teamwork makes the dream work. For more information about breakout rooms see the description on GitHub.
For each session, you can propose a conversation to have in a breakout room or add your name to join a suggestion that is already on the list.
You don’t have to add your name in advance (although you’re welcome to) and you don’t have to stay in the breakout room you’ve put your name next to.
Breakout room conversation topics might include:
GitHub new user or refresher questions (and answers)
Finding a good first issue
Reading and giving feedback on a chapter with the original author
Reading and giving feedback on a chapter with a new reader
Brainstorming where your topics could best fit into The Turing Way
Bug squashing - removing barriers (technical and otherwise)
The person chairing the call will put you into the specific breakout rooms for the Pomodoro sessions and then bring you back into the main room for the 5-minute breaks and the broader conversation at the end of the Collaboration Cafe.