6. NOTES

(This section contains information of a general or explanatory nature that may be helpful, but is not mandatory.)

6.1 Intended use.

This standard contains requirements for the development and documentation of software. Its application is described in 1.2.

6.2 Data requirements.

The following Data Item Descriptions (DIDs) must be listed, as applicable, on the Contract Data Requirements List (DD Form 1423) when this standard is applied on a contract, in order to obtain the data, except where DOD FAR Supplement 227.405-70 exempts the requirement for a DD Form 1423.

Reference Para DID Number DID Title
5.1.1 DI-IPSC-81427 Software Development Plan (SDP)
5.1.2, 5.1.3 DI-IPSC-81438 Software Test Plan (STP)
5.1.4 DI-IPSC-81428 Software Installation Plan (SIP)
5.1.5 DI-IPSC-81429 Software Transition Plan (STrP)
5.3.2 DI-IPSC-81430 Operational Concept Description (OCD)
5.3.3 DI-IPSC-81431 System/Subsystem Specification (SSS)
5.3.3, 5.5 DI-IPSC-81434 Interface Requirements Specification (IRS)
5.4.1, 5.4.2, 5.13.5 DI-IPSC-81432 System/Subsystem Design Description (SSDD)
5.4.1, 5.4.2, 5.6.1, 5.6.2, 5.6.3 DI-IPSC-81436 Interface Design Description (IDD)
5.5 DI-IPSC-81433 Software Requirements Specification (SRS)
5.6.1, 5.6.2, 5.6.3 DI-IPSC-81435 Software Design Description (SDD)
5.4.1, 5.6.1, 5.6.3 DI-IPSC-81437 Database Design Description (DBDD)
5.9.3, 5.11.3 DI-IPSC-81439 Software Test Description (STD)
5.9.7, 5.11.7 DI-IPSC-81440 Software Test Report (STR)
5.12.1, 5.13.1, 5.13.2, 5.13.4 DI-IPSC-81441 Software Product Specification (SPS)
5.12.2, 5.13.3 DI-IPSC-81442 Software Version Description (SVD)
5.12.3.1 DI-IPSC-81443 Software User Manual (SUM)
5.12.3.2 DI-IPSC-81445 Software Input/Output Manual (SIOM)
5.12.3.3 DI-IPSC-81444 Software Center Operator Manual (SCOM)
5.12.3.4 DI-IPSC-81446 Computer Operation Manual (COM)
5.13.6.1 DI-IPSC-81447 Computer Programming Manual (CPM)
5.13.6.2 DI-IPSC-81448 Firmware Support Manual (FSM)

The above DIDs were those cleared as of the date of this standard. The current issue of DOD 5010.12, Acquisition Management Systems and Data Requirements Control List (AMSDL), must be researched to ensure that only current, cleared DIDs are cited on the Form 1423.

6.3 Relationship between standard and CDRL.

If the CDRL calls for a DID different from the one named in corresponding paragraph(s) of this standard, all references to the DID in the standard should be interpreted to mean the one in the CDRL.

6.4 Delivery of tool contents.

Depending on contract provisions, the developer may be permitted to satisfy CDRL requirements by delivering: 1) a repository or database containing the information specified in the cited DID; 2) a means of accessing that repository or database, such as a CASE tool, if not already available to the recipients designated on the CDRL; and 3) a hard-copy or electronically stored table of contents, specifying how and where to access the information required in each paragraph of the DID.

6.5 Tailoring guidance.

This standard and its Data Item Descriptions (DIDs) are applied at the discretion of the acquirer. In each application, the standard and DIDs should be tailored to the specific requirements of a particular program, program phase, or contractual structure. Care should be taken to eliminate tasks that add unnecessary costs and data that do not add value to the process or the product. Tailoring for the standard takes the form of deletion of activities, alteration of activities to more explicitly reflect the application to a particular effort, or addition of activities to satisfy program requirements. This tailoring is specified in the Statement of Work. Tailoring for the DIDs consists of deleting requirements for unneeded information and making other changes, such as combining two documents under one cover, that do not increase the required workload. DID tailoring for deliverables is specified in Block 16 of the CDRL.

6.6 Cost/schedule reporting.

Developer cost/schedule reports should be prepared at the CSCI level. The cost reports should indicate budgeted versus actual expenditures and should conform to the Work Breakdown Structure (WBS) applicable to the development effort. These reports should also indicate to the acquirer planned, actual, and predicted progress.

6.7 Related standardization documents.

Figure 2 identifies a set of standardization documents related to software development. These and other standardization documents may be imposed or quoted in the Statement of Work to supplement the requirements in MIL-STD-498. MIL-STD-498 does not invoke these documents. The acquirer should use caution to ensure that supplemental standards are appropriate to the project and that any conflicts among these standards or with MIL-STD-498 are identified and resolved.

6.8 Subject term (key word) listing.

The following list of key words may be used to catalog or characterize key topics in this standard.

Builds/incremental development

Computer software configuration item

Database

Joint technical/management reviews

Operational concept

Reusable software

Risk management

Security/privacy

Software

Software configuration management

Software development

Software documentation

Software implementation

Software management indicators

Software product evaluation

Software quality assurance

Software requirements analysis

Software safety

Software support

Software testing

Software unit

Tailoring


Translator: Simon Wright simon@pogner.demon.co.uk
Last updated: 22.iii.99