avh4/burndown-charts/1.0.0

BurndownChart

Burndown charts

view : Config -> Html msg

Show a burndown chart

See Config.

type alias Date =
( Int, Month, Int )

(year, month, day)

type alias Config =
{ name : String
, color : Maybe Color
, startDate : Date
, baseline : ( Date, EstimationMethod )
, milestones : List ( String, Int, Maybe Date )
, pointsRemaining : List Int
}
  • name: The name of the project. This will be used as the title of the chart.
  • color: The color used for the burndown line. If not given, this will use the default color from terezka/line-charts.
  • startDate: The start date of the project.
  • baseline: A baseline estimate for the project. This is a tuple containing:
    • The date on which the baseline was set (typically this will be the same as the project start date).
    • The EstimationMethod to use to calculate the goal line.
  • milestones: (optional) A list of intermediate milestones to draw on the chart. Each milestone includes:
    • The name of the milestone (consider using a single-character emoji for this!)
    • The number of points that will remain in the project after this milestone is completed
    • The date the milestone was accepted, or Nothing if it has not been accepted yet.
  • pointsRemaining: A list containing the number of points remaining at the start of each day of the project.

Estimation method

A burndown chart shows a baseline (or goal line) starting from the baseline date with the number of points remaining on that date to the estimated end date (with the slope of the line beind the estimated velocity).

You can specify the target date (a time-based estimate) and have the estimated velocity be calculated; or you can specify the estimated velocity (a scope-based estimate) and have the target date be calculated.

A scope-based estimate where the estimated velocity is specified and the target date will be calculated.

A time-based estimate where the target date is specified and the estimated velocity will be calculated.

Colors

These are the basic colors available in terezka/line-charts exposed here for convenience so you don't have to add line-charts as a direct dependency.

If you want other colors, you can use colors from LineCharts.Colors, any color you can create with avh4/elm-color, or colors from any other package that produces a Color.

red : Color
pink : Color
gold : Color
green : Color
teal : Color
cyan : Color
blue : Color
purple : Color