Concept: Configuration Status Reporting
This guideline describes what is typically included in a Configuration Status Report. A configuration status report is used to describe the "state" of the product based on the type, number, rate and severity of defects found, and fixed, during the course of product development.
Relationships
Related Elements
Main Description

Overview

Tracking the progress of a software project is a difficult task. One of the main problems you face is finding a means by which an objective measurement of actual progress and associated status can be assessed. One approach you should consider is tracking the trends in actual change metrics from your change control system: this approach to measuring progress is referred to as configuration status accounting, and the reporting derived from it is often called configuration status reporting.

Configuration Status Accounting (Measurement) - is used to describe the "state" of the product based on the type, number, rate and severity of defects found, and fixed, during the course of product development. Metrics derived under this aspect of Configuration Management are useful in determining the overall status of completeness of the project.

Four principal sources for software Configuration Status Reports are:

  • Change Requests
  • Software Builds
  • Version Descriptions
  • Audits

Change Requests

A Change Request (CR) is a general term for a request to change an work product or process. The general process associated with CRs is described in Concept: Change Request Management.

The status 'tags' provide the basis for reporting CR (aging, distribution or trend) statistics as described in the CRM process steps.

Change Request based defect reports fall under the following categories:

  • Aging (Time Based Reports)
  • How long have Change Requests of the various kinds been open? What is the 'lag time' of when in the lifecycle defects are found, versus when are they being fixed?

  • Distribution (Count Based Reports)
  • How many Change Requests are there in the various categories by owner, priority or state of fix?

  • Trend (Time and Count Related Reports)
  • What is the cumulative number of defects being found and fixed over time? What is the rate of defect discovery and fix? What is the 'quality gap' in terms of open versus closed defects? What is the average defect resolution time?

    Generalized process flow for Change Requests resulting in Aging Reports, Distribution Reports, and Trend Reports.

Build Reports

Build Reports list all the files, their location, and incorporated changes that make up a build for a specific version of the software.

Build Reports can be maintained both at the system and subsystem level.

Version Descriptions

Similar to Release Notes, Version Descriptions describe the details of a software release. As a minimum the description needs to include the following:

  • Inventory of material released (physical media and documents)
  • Inventory of software contents (file listings)
  • All unique-to-site 'adaptation' data
  • Installation instructions
  • Possible problems and known errors

Audits

There two kinds of audits that are covered in the context of Configuration Management:

  • Physical Configuration Audits
  • Functional Configuration Audits

A Physical Configuration Audit (PCA) identifies the elements of a product to be deployed from the Project Repository.

A Functional Configuration Audit (FCA) confirms that a baseline meets the requirements targeted for the baseline.

The detailed task for performing Audits is described in Perform Configuration Audit.