Community Discussions Workflow¶
This workflow was established for the Instructor Development Committee Discussion Session Coordinator to organise The Carpentries Community Discussions. Between January 2020 and September 2020, this workflow will be managed by Angelique van Rensburg from Carpentries Core Team.
Scheduling Community Discussions¶
Review responses from the Call for Community Discussions Facilitators form.
The Call for Community Discussions Facilitators form includes an integration which, when a form response is received, an e-mail is sent to The Carpentries Discussion Session Coordinator who should then open the attachment and review its contents.
Add potential Community Discussions to the Etherpad.
If the Community Discussions Facilitator proposed a day/time for the community discussion they will be hosting, add that day/time to the Etherpad as TBD in this format:
Themed Discussion Sessions/#CarpentriesConversation DAY OF WEEK, MONTH DAY TIME TIME UTC Click here for your time zone: Topic: Description Host (name & email): Host questionnaire to be completed at the end of call: https://goo.gl/forms/iXkMQABmO6HROfCy1 Co-host/notetaker (name & email): Attending (Name/Affiliation/Twitter): Sharing an upcoming or past workshop? Please add the link to your workshop website along with your name. Attending as part of the instructor checkout requirement? Please add your e-mail address and checkout along with your name. 1. 2. 3. Attendee questionnaire to be completed at the end of call: https://goo.gl/forms/uCeESfUUWsX5dpPu2
Add potential Community Discussion to the community calendar
If the Community Discussions Facilitator proposed a day/time for the community discussion, add that day/time to the community calendar in UTC and assign the Zoom Room carpentries room 2 for the call. If they did not provide a time, include that question in your e-mail to them.
Add potential Community Discussion to the Community Discussions Page on the website
Submit a PR to update the Community Discussions page on The Carpentries website
The appropriate GitHub repository to submit your Pull Request to is here. Add the new community discussion in the upcoming discussions section.
Contact potential Community Discussions Facilitator
Send a version of the following templated e-mail to the individual who completed the form. Once the e-mail has been sent, highlight the row in the spreadsheet yellow indicating that you have contacted the individuals.
Inform The Carpentries Core Team Liaisons about the Community Discussion by emailing
Draft tweets for Community Discussion
Make a copy of this template and draft tweets to spread the word about the Community Discussion.
Send the tweet template to the Communications Manager by emailing
Request Blog Post to Promote Community Discussion
Remind facilitator to write a blog post to get the word out about the community discussion. Here is a handy blog post drafting guide to help them get started
Scheduling Pre- and Post-Workshop Community Discussions¶
Coordinate with Infrastructure Team (Maneesha Sane) regarding quarterly sign-ups. This process has been semi-automated with the use of Calendly.
After signups have closed the Community Discussions Coordinator and Infrastructure Team discuss distributions of time slots identified by Discussions Hosts (during sign-up) per week and time zone. This will result in either extending signups (if more are needed), or cancel duplicate/sessions not needed.
Once finalised the Infrastructure Team publishes the time slots to the Etherpad.
In coordination with IDC’s Communications Coordinator, the Community Development Team will coordinate weekly Tweets and schedule messages to go out in Carpentries Clippings, our fortnightly newsletter, regarding upcoming Community Discussion sessions.
The final version of the Carpentries Community Calendar is populated from Calendly by the Infrastructure Team.
If any additional sessions are added/sessions are changed at a later stage, this is done manually.
The Community Discussions Coordinator checks the Etherpad weekly to view signups (perhaps too few) for sessions as well as if any changes have been made and might impact the Carpentries Community Calendar.
The Community Discussions Coordinator will periodically write blog posts, update mailing lists and provide information via Slack regarding various Community Discussion matters (i.e. quarterly signups, upcoming themed discussions etc) and will have as much support from the Community Development Team as needed throughout this process.
Preparing to Host a Carpentries Community Discussion¶
[Optional] Identify a Community Discussion Moderator
Identify someone to moderator the Community Discussion. This individual will:
Introduce the facilitator
Remind participants that we are following The Carpentries Code of Conduct
Request permission from attendees to record the session.
Take notes during the discussion
Facilitate breakout rooms
Serve as timekeeper
Thank attendees for participating
Remind attendees to complete the questionnaire
Ensure we recognise those attending the discussion for checkout and facilitate Q&A for checkout participants.
Share Zoom Room Credentials & Practice Breakout Rooms
Contact the Community Development Team on
email@example.com case you need alternative Zoom Room Credentials shared.
[Optional] Review The Carpentries Community Discussions Host Onboarding slide deck
Community Discussion Wrap-Up¶
Add Community Discussions Slide Deck to Google Drive
Upload Community Discussion Recording to YouTube
Contact the Community Development Team on
firstname.lastname@example.org have the recording of the Community Discussion uploaded to The Carpentries YouTube Channel.
Add Community Discussion to the Past Calls section of the Community Discussions page on The Carpentries website.
Send thank you notes to the Community Discussion Facilitator & Moderator using this template email as a starting point if need be.
Review Discussion Questionnaire Results
Request access to the results of the Community Discussion Questionnaire. Review the results and share your notes with the rest of the Instructor Development Committee Leadership Team.
Review the Community Discussion blog post and ask Community Development Team to merge by emailing
@kmomarin the PR.
If the discussion host wrote a blog post, review the blog post and the results of the questionnaire. Add/edit blog post content and be sure to include any responses from the survey that are valuable/interesting before requesting the Communications Lead to merge.