Skip to content
This repository has been archived by the owner on May 15, 2023. It is now read-only.

Use Story Points in GitHub Project board without a hassle. No labels or issue title modifications needed.

License

Notifications You must be signed in to change notification settings

pkosiec/github-projects-story-points

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 

Repository files navigation

GitHub Projects Story Points

⚠️ DEPRECATED: This project is no longer needed as GitHub issues supports custom fields now. Use number fields to add estimations to your issues and display sum of the field on your board.

Use Story Points in GitHub Project board without a hassle. No labels or issue title modifications needed.

Preview

Motivation

There are plenty of similar tools. However, all existing plugins or scripts I found base on Github labels or tags in task titles, which doesn't look professional. I prepared the script to keep the estimations internal, visible only on GitHub Project boards. The boards can set as private, which means this script allows to show Story Points only for authors or organization members.

Features

The script has the following features:

  • Show total Story Points number per column
  • Show number of estimated cards and total cards number per column
  • Highlight not estimated cards
  • Highlight cards with invalid estimation
  • Show total Story Points on the project board
  • Ignore specific columns

Current implementation of the script recalculates Story Points every 2 seconds.

Installation

  1. Install Violentmonkey (open source) or Tampermonkey (closed source) plugin for your favorite web browser.
  2. Navigate to the GitHub Project Story Points User Script location. The script format is detected automatically and Tampermonkey will ask to install it.
  3. The userscript manager will watch the script location and it will update the script automatically once new version is released.

Usage

  1. Navigate to your GitHub Project board.
  2. Add a note to a column with a task description.

    NOTE: To reference actual issue, paste a link into the note.

  3. To define your Story Points value, include the following codeblock:
    ```est
    SP: {value}
    ```
    
    For example, for Story Points value of 3, the actual codeblock is:
    ```est
    SP: 3
    ```
    
  4. Observe Story Point Column Summary update.

Configuration

Currently the plugin doesn't expose official configuration options. As a workaround, you can modify the following lines of the script:

const refreshInterval = 2000;
const highlightNotEstimatedCards = true;
const showTotalBoardStoryPoints = true;

// the column cards will be excluded from validation and counting Story Points:
// both from column and board Story Points count.
const excludedColumns = ["Inbox"];

// the column cards will be validated as usual and the column summary will be visible,
// but the Story Points from this column won't be counted towards the board total Story Points.
const excludedColumnsFromBoardStoryPointsCount = ["Backlog"];

However, keep in mind that every script update will overwrite your configuration values.

Example

To see a live example, install the script and navigate to the sample GitHub Project.

About

Use Story Points in GitHub Project board without a hassle. No labels or issue title modifications needed.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published