Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
73 changes: 73 additions & 0 deletions docs/contribution_sprints/communication_examples.md
Original file line number Diff line number Diff line change
@@ -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

---
58 changes: 58 additions & 0 deletions docs/contribution_sprints/playbooks.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
---
layout: page
title: Sprints Playbooks
parent: Contribution Sprints
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.

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 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
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.
4 changes: 3 additions & 1 deletion mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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"
Expand All @@ -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":
Expand Down