Phlogiston/Guide to Phlogiston Reports

Index

 * Full list of possible categories. This report shows all of the tasks Phlogiston sees for this scope, grouped by the project tag, projectcolumn, and parent Category tags.  It is intended to be used in helping create categorization rules for scopes.
 * Rules for recategorizing tasks This is a link to the github file driving categorization for this scope.
 * Recently closed tasks. This is a link to a list of all tasks resolved in the last two weeks, along with the category that Phlogiston has determined for the task following the recategorization rule.
 * All open tasks, sorted by category. This is a list of all open tasks in this scope, grouped by category.
 * Histogram of stories by points. This is a histogram of the point value of all resolved stories, grouped by Phabricator Priority field. Each row is a different Phabricator priority, from 10 = lowest to 90 = Untriaged and 100 = Unbreak Now!, plus an All Priorities row at the bottom.  It is intended to help determine if a default value of points for unpointed stories is useful.  The current default point value for unpointed stories is also shown; this is taken from the configuration file for this scope.

Report metadata

 * "Most Recent Data" is the date of the most recently changed data for any task in this scope. Data is dumped around 3 am UTC every day, so changes after the dump will not be reflected.
 * "Report Date" is the date that the report was generated. Reports should run daily, so this may be helpful for determining if fresh report generation is stalled.
 * "These charts include ..." is the complete list of Phabricator project names used to generate this report. The report should include all tasks with these project tags.

Forecast
The Forecast charts show all defined categories for a scope of reporting, and for each category show the total amount of work, date completed or forecast completion, and fraction complete as of now.



Categories
All of the categories defined for a scope are listed in descending order by priority. There are two versions of this chart, zoomed and unzoomed; the zoomed version excludes any categories that are hidden (for example, a Product Owner may hide categories that were completed in the past) and the unzoomed version shows all categories.

Chart Area
The current quarter is indicated with a lighter-shaded rectangle. Today's date (the date the report was last run on) is indicated with a vertical blue line.

Size of category
The size of each category is shown via a number at the left of the plot for each category. This is the total number of tasks for the category; the number is shown zoomed in proportion to its log. For point-based charts, a dot is shown instead of a number, with the area of the dot proportional to the total number of points.

Completion Date
If a category has been completed, as defined by having zero open tasks and more than zero resolved tasks, the date that happened in shown with a black diamond and label. If the category is completed, re-opened, and re-completed, this is [not sure, probably the first time that was true?]. If a category has open tasks, this chart shows a forecast of when the category will be complete, based on historical changes to the amount of open tasks and the rate of resolution. The error bar shows the range from optimistic for pessimistic forecast, and the hollow diamond and date label show the nominal forecast. All forecast dates are in terms of weeks relative to today. See Phlogiston/Forecasting Model for more information on how these numbers are determined.

Current Status
For all incomplete categories, the percentage of tasks (or points) completed is shown in blue along the Now line.

Combined Burnup
This chart shows



This chart shows the total amount of work in scope, with resolved work above the X axis and open work below. Categories are sorted with the top riority closest to the axis. This chart shows the relative size of different categories of work, the ratio of completed to incomplete work for each category, and the changes in this information over time.

An increase above the X axis means that more work has been completed. An increase below the X axis means that more work has been added. If a category grows above the axis while staying relatively flat below the axis, that means that the category is growing in size as fast as it is being completed.

Unzoomed Burnup
The Combined Burnup chart usually excludes several categories of work that are not relevant to current planning: work that was completed in the past, and work that is not actively being considered, such as "freezer" or "unplanned backlog" work. The "Unzoomed" link below each Zoomed Combined Burnup chart shows the same chart including all categories. This is typically useful for comparison to the zoomed chart, to see the relative size and trend in relevant and irrelevant work.



Per-category charts
Phlogiston generates additional charts for each category. These are presented as hidden tabs in the "Per-Category Burnups" section:



Clicking on any Category title shows three types of category-specific chart, each presented for both points and count:



Per-Category Burnup
The Per-Category Burnup shows the total amount of work for a category as a shaded area over time, and the amount of resolved work as a solid black line. The future growth of the backlog is forecast with three gray lines; the dotted gray lines show the pessimistic (top) and optimistic (bottom) forecasts for backlog growth based on past growth and the thicker, dashed gray line shows the nominal forecast. The future amount of completed work is forecast with three black lines, the dotted black lines showing optimistic (top) and pessimistic (bottom) forecasts and the thicker, dashed line the nominal case.



Reading the burnup forecast
The point at which the steepest dotted black line touches the lowest dotted gray line is the earliest date this category is likely to finish, assuming changes to backlog and completion are consistent with past changes.
 * If the bottom black dotted line doesn't converge with the top dotted gray line, there is a reasonable possibility that the category will never finish. I.e., the pessimistic forecast is never.  This is true in the example above.
 * If the thicker dashed lines are parallel or diverging, it is unlikely that the project will finish because the backlog is growing faster than it is being completed. Unless backlog growth is halted or velocity is increased, the project will not finish.  I.e., the nominal forecast is never.  Example:
 * If the top black dotted line doesn't converge with the bottom dotted gray line, there is essentially no chance the project will finish if current trends continue. The optimistic forecast is never.  Example: