From 1a2b9a4f8e108dc2ed04f6eebf78baabba485f65 Mon Sep 17 00:00:00 2001 From: Tim Schilling Date: Tue, 7 Apr 2026 10:31:36 -0500 Subject: [PATCH 1/4] Add sprints playbook page This page will house specific actions with detailed tasks. --- docs/contribution_sprints/playbooks.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 docs/contribution_sprints/playbooks.md diff --git a/docs/contribution_sprints/playbooks.md b/docs/contribution_sprints/playbooks.md new file mode 100644 index 0000000..e75d3db --- /dev/null +++ b/docs/contribution_sprints/playbooks.md @@ -0,0 +1,26 @@ +--- +layout: page +title: Sprints Playbooks +parent: Contribution Sprints +nav_order: 4 +--- + +This page contains the information on specific actions for the sprints team. + +## Preparing participants + +The ti.to ticket flow includes questions for each Sprints ticket. They ask if the person if they are leading sprints and interested in receiving support before the conference as well as if they are participating in sprints and interested in receiving support. + +The purpose here is to collect identify the people we can reach out to for two reasons: + +1. They are a sprint leader and need help preparing their project for sprints. +2. They are a prospective contributor and want help getting prepared for sprints. + +These participants can be found at https://automation.defna.org/sprints/tickets/. You will need staff permissions to review the information. Ask the automation team in the `#automation` channel for help here. + +1. Browse to https://automation.defna.org/sprints/tickets/ +2. Download the CSV +3. Filter to the relevant participants +4. Upload the email list to a spreadsheet. Include a timestamp on the column in case we edit it. Include your own email for confirmation purposes. +5. Craft an email text in a Google Doc or similar. Be minimalistic. Include subject line. The communications team can include a button as a link for any call to action. +6. Post on `#communications` channel that you need help sending an email and include the link to the email draft document. It's probably best if they upload the people to be emailed to a email list, such as `YYYY Sprint Leaders` or `YYYY Sprint Contributors` From 7c2639765f0d25412228d32657e5a75be237daec Mon Sep 17 00:00:00 2001 From: Tim Schilling Date: Tue, 7 Apr 2026 11:31:38 -0500 Subject: [PATCH 2/4] Update docs/contribution_sprints/playbooks.md Co-authored-by: Drew Winstel --- docs/contribution_sprints/playbooks.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/contribution_sprints/playbooks.md b/docs/contribution_sprints/playbooks.md index e75d3db..1ac4bb4 100644 --- a/docs/contribution_sprints/playbooks.md +++ b/docs/contribution_sprints/playbooks.md @@ -16,7 +16,7 @@ The purpose here is to collect identify the people we can reach out to for two r 1. They are a sprint leader and need help preparing their project for sprints. 2. They are a prospective contributor and want help getting prepared for sprints. -These participants can be found at https://automation.defna.org/sprints/tickets/. You will need staff permissions to review the information. Ask the automation team in the `#automation` channel for help here. +These participants can be found at https://automation.defna.org/sprints/tickets/. You will need staff permissions to review the information. Ask the automation team in the `#automation` channel on Slack for help here. 1. Browse to https://automation.defna.org/sprints/tickets/ 2. Download the CSV From ffe242b2b9b02b08e84b741a800ced07fd87f473 Mon Sep 17 00:00:00 2001 From: Tim Schilling Date: Tue, 7 Apr 2026 13:17:40 -0500 Subject: [PATCH 3/4] Account for both types of participants. --- docs/contribution_sprints/playbooks.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/contribution_sprints/playbooks.md b/docs/contribution_sprints/playbooks.md index 1ac4bb4..f6c3794 100644 --- a/docs/contribution_sprints/playbooks.md +++ b/docs/contribution_sprints/playbooks.md @@ -7,7 +7,7 @@ nav_order: 4 This page contains the information on specific actions for the sprints team. -## Preparing participants +## Preparing sprint leaders/contributors The ti.to ticket flow includes questions for each Sprints ticket. They ask if the person if they are leading sprints and interested in receiving support before the conference as well as if they are participating in sprints and interested in receiving support. @@ -18,6 +18,8 @@ The purpose here is to collect identify the people we can reach out to for two r These participants can be found at https://automation.defna.org/sprints/tickets/. You will need staff permissions to review the information. Ask the automation team in the `#automation` channel on Slack for help here. +The following steps need to be completed for each type of participant: + 1. Browse to https://automation.defna.org/sprints/tickets/ 2. Download the CSV 3. Filter to the relevant participants From 5efcf3726b7240281c9cf4e0d001b6b613a67f2e Mon Sep 17 00:00:00 2001 From: Tim Schilling Date: Tue, 21 Apr 2026 10:27:15 -0500 Subject: [PATCH 4/4] Add office hours for new sprinter playbook and communication example. --- .../communication_examples.md | 73 +++++++++++++++++++ docs/contribution_sprints/playbooks.md | 30 ++++++++ mkdocs.yml | 4 +- 3 files changed, 106 insertions(+), 1 deletion(-) create mode 100644 docs/contribution_sprints/communication_examples.md diff --git a/docs/contribution_sprints/communication_examples.md b/docs/contribution_sprints/communication_examples.md new file mode 100644 index 0000000..753172f --- /dev/null +++ b/docs/contribution_sprints/communication_examples.md @@ -0,0 +1,73 @@ +--- +layout: page +title: Sprints Communications +parent: Contribution Sprints +nav_order: 5 +--- + +This page contains example copy for emails and social media posts used by the sprints team. + +## Table of Contents + +- [Sprint leader outreach email](#sprint-leader-outreach-email) +- [Office hours invite email](#office-hours-invite-email) + +## Sprint leader outreach email + +Send this to ticket holders who indicated they are leading a sprint and want support. K + +**Subject:** Preparing for DjangoCon US YYYY Sprints + +--- + +Hi [Name], + +Thanks for signing up to lead a sprint at DjangoCon US YYYY for your project! We want to help people maximize their time at the sprints. Can you please **email us back with what project(s) you're planning on leading**? + +We'd like to mention the project to contributors before the conference so they can learn more about it and get their development machine set up. + +While not required, here are a few things that help contributors get started quickly: + +- A `CONTRIBUTING.md` or similar guide in your repo that's locatable +- Issues tagged with `good first issue` or `sprints` +- A working local development setup documented in your README + +If you'd like help with any of the above, or have questions about leading a sprint, reply to this email and we'll be happy to assist. + +We're looking forward to seeing your project at the sprints! + +[Your name] +DjangoCon US YYYY Sprints Team + +--- + +## Office hours invite email + +Send this to ticket holders who expressed interest in contributor support. Attach a `.ics` calendar file for each session so recipients can add the events directly to their calendar. + +**Subject:** Maximize your DjangoCon US sprinting, set up your local environment at Office Hours + +--- + +Hello future contributors! + +You're receiving this email because when you registered, you noted that you'd like help getting ready to contribute at the DjangoCon US YYYY sprints. + +To help with that, we're hosting several office hours sessions. Each is a relaxed, virtual session where we'll walk through **setting up a local development environment** and answer any questions you have before the sprints begin. This means you can focus more of your time at the sprints on collaboration! + +Pick the session that works best for you — calendar invites for each are attached to this email. + +**Session N: [Date] · [Time] UTC** ([convert to your timezone](https://time.is/compare/[HHMM]_[DD]_[Month]_[YYYY]_UTC)) +[Video call link] + +**Session N+1: [Date] · [Time] UTC** ([convert to your timezone](https://time.is/compare/[HHMM]_[DD]_[Month]_[YYYY]_UTC)) +[Video call link] + +If you have any questions beforehand, feel free to reply to this email. + +Hope to see you there, + +[Your name] +DjangoCon US YYYY Sprints Team + +--- diff --git a/docs/contribution_sprints/playbooks.md b/docs/contribution_sprints/playbooks.md index f6c3794..98fc308 100644 --- a/docs/contribution_sprints/playbooks.md +++ b/docs/contribution_sprints/playbooks.md @@ -7,6 +7,11 @@ nav_order: 4 This page contains the information on specific actions for the sprints team. +## Table of Contents + +- [Preparing sprint leaders/contributors](#preparing-sprint-leaderscontributors) +- [Hosting office hours for new Sprinters](#hosting-office-hours-for-new-sprinters) + ## Preparing sprint leaders/contributors The ti.to ticket flow includes questions for each Sprints ticket. They ask if the person if they are leading sprints and interested in receiving support before the conference as well as if they are participating in sprints and interested in receiving support. @@ -26,3 +31,28 @@ The following steps need to be completed for each type of participant: 4. Upload the email list to a spreadsheet. Include a timestamp on the column in case we edit it. Include your own email for confirmation purposes. 5. Craft an email text in a Google Doc or similar. Be minimalistic. Include subject line. The communications team can include a button as a link for any call to action. 6. Post on `#communications` channel that you need help sending an email and include the link to the email draft document. It's probably best if they upload the people to be emailed to a email list, such as `YYYY Sprint Leaders` or `YYYY Sprint Contributors` + +## Hosting office hours for new Sprinters + +Office hours are where new contributors can get their development environment set up and ask questions before the sprints. + +### Steps + +1. Pick a date and time(s). Aim for one to two weeks before the conference sprints. +2. Create a `.ics` calendar file for each session. See [.ics file guidance](#ics-file-guidance) below. +3. Fetch the list of ticket holders who expressed interest in contributor support. Follow the same steps as [Preparing sprint leaders/contributors](#preparing-sprint-leaderscontributors) and filter to prospective contributors. +4. Craft the invite email using the template in [communication examples](communication_examples.md). Follow step 5 of [Preparing sprint leaders/contributors](#preparing-sprint-leaderscontributors) to send it via the communications team. Include the `.ics` files with the email draft so the communications team can attach them. +5. Ask the communications team (via `#communications` on Slack) to post on social media. Provide them with a short description and any relevant hashtags (e.g. `#DjangoConUS`, `#Django`). +6. Host the session. Share screen to walk through environment setup steps. Leave time for open Q&A. + +### .ics file guidance + +A `.ics` file lets recipients add the event to any calendar app (Google Calendar, Apple Calendar, Outlook, etc.). + +The simplest approach is to create the event in Google Calendar and export it: + +1. Create the event in Google Calendar with the correct date, time (UTC), and video call link in the location field. +2. Open the event, click the three-dot menu, and select **Publish event**. +3. Copy the `.ics` link, or download the file directly to attach to the email. + +Alternatively, use an online generator such as [icalendar.org](https://icalendar.org/ical-generator.html) to build the file manually. Create one `.ics` file per session. diff --git a/mkdocs.yml b/mkdocs.yml index 48500cc..63aae88 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -51,6 +51,8 @@ nav: - "contribution_sprints/about.md" - "contribution_sprints/checklist.md" - "contribution_sprints/history.md" + - "contribution_sprints/playbooks.md" + - "contribution_sprints/communication_examples.md" - "Health and Safety": - "health_and_safety/about.md" - "health_and_safety/checklist.md" @@ -71,7 +73,7 @@ nav: - "marketing/about.md" - "marketing/checklist.md" - "marketing/history.md" - - "marketing/communications.md" + - "marketing/communication_examples.md" - "marketing/mailing_lists.md" - "marketing/remarks.md" - "Online Committee":