28.20. ReviewActivity

28.20.1. Description

ReviewActivity reduction function computes single or multiple stream(s) representing project review active time.

"Regular" Active Time shows the time spent editing files. When doing code review, however, almost all of the time is not spent editing files, but merely browsing them. To track this kind of "Active" time, we created a new kind of sensor data that tracks the time spent in a code review tool simply navigating around or creating issues. This kind of sensor data can be used to generate "Review Active Time". Currently, only the Jupiter code review plugin for Eclipse can generate this kind of sensor data.

28.20.2. Parameter

Table 28.19. 

ParameterDescriptionDefault
modeOne of 'Project' or 'Individual'. Project
filePatternAnt-like file pattern specifying the files to be included in computation.**
isCumulativeIf true, an cumulative version of telemetry stream is returned.false

28.20.3. Example

Example 28.30. Review Active Time Telemetry

streams ReviewActiveTimeStream(mode, filePattern, isCumulative) = {
   "Review Active Time", 
   ReviewActivity(mode, filePattern, isCumulative)
};

y-axis yAxis(label) = {label};

chart ReviewActiveTimeChart() = {
  "Review Active Time", 
  (ReviewActiveTimeStream("Project", "**", "false"), yAxis("Review Active Time"))
};

draw ReviewActiveTimeChart();

This chart shows the definition of a Review Active Time Stream and Chart that has been parameterized to display the total amount of review active time over the course of several weeks.

This telemetry data shows a fair degree of variation in the amount of time devoted to review during each week; ranging from no time at all during some weeks to 7-8 hours in other weeks.