Skip to content

Instantly share code, notes, and snippets.

@ginatrapani
Last active May 25, 2016 17:35
Show Gist options
  • Star 2 You must be signed in to star a gist
  • Fork 2 You must be signed in to fork a gist
  • Save ginatrapani/11303222 to your computer and use it in GitHub Desktop.
Save ginatrapani/11303222 to your computer and use it in GitHub Desktop.
New insight issue template

One-liner

Describe what this insight is in a single sentence. This is the description that appears in ThinkUp's insights list, so phrase it like the others are. Current insights single sentences are:

  • Post activity spikes for the past 7, 30, and 365 days.
  • How often you referred to yourself ("I", "me", "myself", "my") in the past week.
  • How many more users a message has reached due to your reshare or retweet.

Full explainer

How does it make the user feel? What is the goal of this insight?

Audience for the insight

Which networks, if any, are excluded from this insight?

Does this insight serve users with less or more activity?

First-run: does this insight show up on a user's first crawl?

How often this insight runs

  • Always (triggered by a data event, check the data and update insight on every crawl)
  • Daily (check the data once a day, don't regenerate every crawl)
  • Weekly on a fixed day (specify day of week per network to space these out)
  • Monthly on a fixed day with bonus magic day within first 2 weeks of use (specify day of month per network to space these out)
  • Annual on a fixed date (specify day of year)
  • Annual every 365 days from first appearance

Headline

Include multiple variations, use third person and variables for localized network terminology.

For example:

  • %username has passed %total %followers!
  • More than %total people are %following %username

Body

Include multiple variations whenever possible.

For example:

  • That's more than the population of Belize.
  • That's more people than can fit in Yankee Stadium.

Tout

Explain how ThinkUp can help potential users, basing copy on the insight.

For example:

  • Want a handy list of the links you've favorited? We can help!
  • Get a look back at what you were doing on this day in years past.

Criteria and logic

Describe the rules for when this insight runs.

  • What data does this insight need? Last week's posts? Last month's? Just the user's posts?
  • Does the insight count replies as well as non-replies?
  • Are there baseline comparisons? What is the logic around the comparison?
  • Are there special copy cases? (for example, if the baseline comparison matches)
  • Is there a minimum threshold for any bit of data before the insight should get generated?

Emphasis

  • High
  • Medium
  • Low

Included elements

  • Headline
  • Text
  • Header image (image off to the left in side-by-side style insights)
  • Hero image (giant image on top)
  • List of user(s)
  • List of post(s)
  • List of link(s)
  • Action button (please specify button label and URL button should link to)
  • Line chart
  • Bar chart
  • Other viz
  • Other graphic treatment

Action button

Specify the following action button attributes:

Hero image

If your insight includes a hero image, we encourage you to use public domain or CC-licensed images. Hero images should be at least 540px wide and be landscape. (They can be portrait, but then they're quite tall.)

Specify the following hero image attributes:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment