Skip to content

IFTTT/clubhouse-users-guide

Repository files navigation

Overview

Why do we need this guide?

Communication is by far the most important capability that Shortcut provides. Shortcut is the most important communication tool that we have at IFTTT. If Slack, Gmail, SMS, VoIP and all other communication methods are not available, our business should be able to keep moving forward with Shortcut. At least temporarily. 😉

Visibility is another very important capability that Shortcut provides. Though, it's important to understand that the visibility that Shortcut provides depends on us using Shortcut in a consistent way.

In order to aggregate Shortcut data, the attributes related to the entities in the data must have consistent semantics. This document defines the semantics in a way that makes sense to the IFTTT team and sets some basic rules to ensure data consistency.

Mapping IFTTT Concepts to Shortcut

The following diagram maps IFTTT organizational and process concepts to Shortcut features. This mapping provides a clear conceptual understanding of how we use Shortcut to get work done at IFTTT.

This diagram uses Crow’s Foot Notation to show associations, which tells us:

  • Projects represent IFTTT components or services and can be associated with many stories
  • Milestones represent Impact Cycles and can be associated with many Epics
  • Epics may or may not be associated with a single Milestone
  • Epics are related to zero or more stories
  • Teams represent squads and can be associated with many Epics, Stories and Iterations
  • Teams can be associated with many Iterations
  • Iterations must be associated with one and only one team
  • Stories must belong to one and only one Project, Epic and Team

Note: The above association rules are how IFTTT uses Shortcut. In some cases Shortcut will allow the above rules to be broken.

Time View

Shortcut allows us to group and track Stories (the work we do) in many different ways. These groupings tend to fall into one of two categories:

  • Timebox - A way to group Stories into a fixed chunk of time in which work is planned to be done.
    • Typically begins with a planning session and ends with a retrospective.
    • Typically fixed in size and length to help with visibility and estimation.
  • Workbox - A set of related work to be done in order to complete a specific goal, feature-set or initiative.
    • A workbox is not constrained by time; it may last be a few days, a few weeks or forever.
    • A workbox can group work using any number of attributes: team, component, service, etc.

Timeboxes

We use several different timeboxes at IFTTT to track work in the time domain: Impact Cycles, Epics and Sprints.

Impact Cycle (Milestone)

An Impact Cycle is a timebox that aims to consolidate and focus work on large initiatives that have strategy-level outcomes typically measured by quarterly metrics. Impact Cycles typically last 6 weeks.

Epic (Epic)

We use Shortcut Epics as both a timebox as well as a workbox. An Epic is a group of related stories (a workbox) that has a start and end date (a timebox), though the start/end dates could be infinite.

Sprint (Iteration)

A Sprint is a timebox that is used to plan and execute on very small amounts of well-defined work. Sprints typically last 2 weeks.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published