From c6a69b0498e7aa38c9dc8a5202cf20f7fb82374f Mon Sep 17 00:00:00 2001 From: Chris Holdgraf Date: Thu, 13 Jan 2022 12:45:32 -0800 Subject: [PATCH] ENH: Convert team syncs from issues to slack only (#347) --- ...{team-update.md => team-update.ARCHIVEDmd} | 8 +++++ ...sync.yaml => close-team-sync.ARCHIVEDyaml} | 3 ++ ...ync.yaml => create-team-sync.ARCHIVEDyaml} | 3 ++ conf.py | 1 + meetings/eng/2021.md | 1 - practices/development.md | 29 ++++++++++++++++++- practices/index.md | 20 ------------- 7 files changed, 43 insertions(+), 22 deletions(-) rename .github/ISSUE_TEMPLATE/{team-update.md => team-update.ARCHIVEDmd} (79%) rename .github/workflows/{close-team-sync.yaml => close-team-sync.ARCHIVEDyaml} (83%) rename .github/workflows/{create-team-sync.yaml => create-team-sync.ARCHIVEDyaml} (83%) diff --git a/.github/ISSUE_TEMPLATE/team-update.md b/.github/ISSUE_TEMPLATE/team-update.ARCHIVEDmd similarity index 79% rename from .github/ISSUE_TEMPLATE/team-update.md rename to .github/ISSUE_TEMPLATE/team-update.ARCHIVEDmd index 4111651c..a4acd29b 100644 --- a/.github/ISSUE_TEMPLATE/team-update.md +++ b/.github/ISSUE_TEMPLATE/team-update.ARCHIVEDmd @@ -1,3 +1,11 @@ +""" +NOTE: This markdown file is archived, as we have moved our team updates to +use the Slack Geekbot. However, we're keeping it in the repository for now in +case we'd like to revisit this practice. + +If we haven't touched this file or needed it by March 2022, we should +delete it and the GitHub actions associated with it! +""" --- name: "♻ Team sync" about: Syncronize the team's goals and actions diff --git a/.github/workflows/close-team-sync.yaml b/.github/workflows/close-team-sync.ARCHIVEDyaml similarity index 83% rename from .github/workflows/close-team-sync.yaml rename to .github/workflows/close-team-sync.ARCHIVEDyaml index d4faec13..9467bfae 100644 --- a/.github/workflows/close-team-sync.yaml +++ b/.github/workflows/close-team-sync.ARCHIVEDyaml @@ -1,3 +1,6 @@ +# ** +# Archived: delete this in March 2022 if we don't decide to re-use it by then. +# ** # From https://github.com/marketplace/actions/close-matching-issues name: Close a weekly team sync issue on: diff --git a/.github/workflows/create-team-sync.yaml b/.github/workflows/create-team-sync.ARCHIVEDyaml similarity index 83% rename from .github/workflows/create-team-sync.yaml rename to .github/workflows/create-team-sync.ARCHIVEDyaml index 96b97338..7d7f07bd 100644 --- a/.github/workflows/create-team-sync.yaml +++ b/.github/workflows/create-team-sync.ARCHIVEDyaml @@ -1,3 +1,6 @@ +# ** +# Archived: delete this in March 2022 if we don't decide to re-use it by then. +# ** name: Open a weekly team sync issue on: schedule: diff --git a/conf.py b/conf.py index 93989b18..c2aedc42 100644 --- a/conf.py +++ b/conf.py @@ -66,6 +66,7 @@ "https://drive.google.com*", # Because it's almost always private "https://icsi.berkeley.edu*", # Because it's broken often "https://sociocracyforall.org*", # Because it raises a 403 but still works + "https://airtable.com*", # Because it has some kind of security that returns a 403 ] diff --git a/meetings/eng/2021.md b/meetings/eng/2021.md index 7c3798f4..191fe257 100644 --- a/meetings/eng/2021.md +++ b/meetings/eng/2021.md @@ -12,7 +12,6 @@ All of the discussions here were already encoded as issues and google docs (link ### Paid Time Off / Holiday plans (25m) -- [Proposal language](https://docs.google.com/document/d/1uvfcQUJYZXK0RTLOQ6lx3Lc7JzSbm_p0sieWK6OQ1bQ/edit) - High-level policy - don't ask for permission, but do be transparent and do coordinate with the team - Unlimited PTO, target of 40 days, don't distinguish between personal and national holiday diff --git a/practices/development.md b/practices/development.md index 0cface1e..c6b091b1 100644 --- a/practices/development.md +++ b/practices/development.md @@ -30,7 +30,7 @@ Wednesday (beginning of sprint) During the sprint : Team members work on the items assigned to them at the sprint planning meeting. We use [the Sprint Board](coordination:sprint-board) to coordinate our activities during the sprint. - On Mondays, each team member fills out a **team sync update** to share the major things they worked on, and note any unexpected challenges or blockers. + We provide updates about what we've been up to, what we're doing next, and where we need help via regular **asynchronous Slack stand-ups**. Tuesday of week 2 (end of sprint) : By the end of the day, team members should have completed all of their items for that sprint. @@ -74,6 +74,33 @@ The Sprint Board is broken down into these columns: In addition, we have a few other pieces of metadata to signal different kind of actions that would be needed + +(coordination:team-syncs)= +## Daily team syncs + +Throughout the week we have a lightweight asynchronous team sync process so that we can get on the same page. +These currently happen on Monday, Wednesday, and Friday in the morning time of each team member. +The primary goals of this process are: + +- To ensure that nobody is stuck on something +- To signal-boost requests for review and help +- To provide accountability of what we've been up to +- To help us coordinate what to do next + +We use [the Geekbot](https://geekbot.com/) to manage this process. +During a sync, each team member gets a message in their morning time with a few questions. +Answer each question, and at the end the answers will be posted to our `#team-updates` channel. + +:::{seealso} +You can customize the way that Geekbot standups work for you. +See [the Geekbot workflow guides](https://help.geekbot.com/en/articles/4283332-commands-how-to-streamline-your-workflow) for some helpful information. +::: + +:::{admonition} TODO: Share this publicly +We are exploring ways to aggregate and share our team sync activity publicly, to be more transparent with others about what we are up to. +We will update this section once we better-understand this process. +::: + (coordination:deliverables)= ## Deliverables and work issues diff --git a/practices/index.md b/practices/index.md index 137e54b0..742d65af 100644 --- a/practices/index.md +++ b/practices/index.md @@ -13,26 +13,6 @@ Here are the goals we optimize for in organizing our team coordination practices We want to do this with high efficiency so that people can quickly get on the same page and focus efforts around decision-making and collaboration. We also wish to do it in a 💯 remote-friendly way since we are split across many different time-zones. - -(coordination:team-syncs)= -## Weekly team syncs - -Every Monday, the 2i2c Hub Operations team conducts a team sync to get on the same page and coordinate their tasks for the week. - -A GitHub Action will automatically create a new Team Sync issue at the beginning of each Monday. -This action uses [this issue template](https://github.com/2i2c-org/team-compass/blob/main/.github/ISSUE_TEMPLATE/team-update.md) and inserts currently open/actionable issues before creating the sync issue. - -Here is the process for our team syncs. - -1. **On Mondays a new issue is created automatically**. This issue is our space to discuss, update, and sync. -2. **Team members give their responses**. You can copy/paste the template, and then give your responses in comments to the issue. You shouldn't feel forced to add content if you can't think of anything, use it as much as is useful. -3. **Discuss and agree on next steps throughout the day**. The goal is to ensure that important issues have somebody paying attention to them, and that team members are supported in the tasks they work towards. At the end of the day the issue is automatically closed. - -```{note} -While these syncs happen once a week, the process of communicating with team members and working on tasks / deliverables can be dynamic and constantly updating. -The syncs are just to get everyone on the same page. -``` - ```{toctree} communication development