bannerd

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Tabsetup
01. Introduction
12. Defining the Activity
23. Software Assurance
Div
idtabs-1

1. Introduction

Note

Typically starts with a quote from the NPR that helps define the activity. Additional descriptive material is meant to help define the activity but not be so detailed that it pulls in all of the guidance from the SWEs in the activity. 

Panel
borderColorblue
titleNPR 7150.2B para 4.3.1

Include Page
2D-Para 4.3.1
2D-Para 4.3.1
Software peer reviews and inspections are the in-process technical examination of work products by peers to find and eliminate defects early in the life cycle. Software peer reviews and inspections are performed following defined procedures covering the preparation for the review, the review itself is conducted, results are recorded, results are reported, and completion criteria is certified. When planning the composition of a software peer review or inspection team, consider including software testing, system testing, software assurance, software safety, software cybersecurity, and software IV&V personnel.

Panel
borderColorblack
borderWidth2
titleInputs, Outputs, and Predecessor Activities

Activity graphical representation of Inputs, Outputs, Predecessor and Successor Activities as appropriate. Not meant to be exhaustive, but representative of a typical project. 

Image Added

1.1 Inputs

Note

List of some of the inputs from other activities that are necessary for the activity to begin. 

Examples: 

Planning - Peer Reviews are planned activities. They appear in the plans and schedules for the project

  • Requirements - These are the things that are Peer Reviewedinfluence the design of the software
  • Architecture Items Documents- These are the things that are Peer Reviewed
  • Design items - These are the things that are Peer Reviewed
  • Test Plans and Procedures - These are the things that are Peer Reviewed
  • These influence the design of the software

1.2 Predecessor Activities

Note

List of some of the other activities that must be started (not necessarily completed) so that this activity may begin. 

Examples: 

Predecessor Activities are performed before Peer Reviews. These activities produce the work products that will be reviewed. 

  • Life Cycle Planning - plans, schedules, estimates, etc.
  • Software Architecture 
  • Software Design
  • Design activities are included in the plan and schedules
  • Requirements - These influence the design of the software
  • Architecture - These influence the design of the softwareSoftware Testing - plans and procedures

1.3 Outputs

Note

List of some of the outputs or work products of the activity. These are typically used as inputs by the downstream activity. In some cases there is a supporting SWE associated with the work product. 

Examples: 

The activities that initiated the Peer Review, receive the findings from Peer Reviews, Those activities then use those findings to to fix defects and implement improvements uncovered in the reviews. 

  • Life Cycle Planning
  • Software Architecture 
  • Software Design
  • Software Testing
  • Configuration Management
  • Coding
    Output Work ProductUsed by Downstream Activity
    • Implementation and Unit Testing


    • Implementation and Unit Testing
    • Implementation and Unit Testing
    • Peer Review Findings

    1.4 Successor Activities

    Note

    Links to Activities which might be started or supported by this activity

    • Implementation and Unit Testing - Implements the Design into one or more code modules

    1.5 Activity Repetition

    Note

    Describe what conditions determine if the activity needs to be repeated, such as re-planning after a change in requirements or schedule constraints. 

    • How much of the activity needs to be repeated
    • Frequency of repetition
    • Design is always done once. Ideally it will be peer reviewed and analyzed by Software Assurance. 
    • Design may be reviewed and re-analyzed as often as there are significant changes in architecture or requirements. For example,  
      • Technology changes to the architecture requires changes to the design
      • Customer changes to requirements require changes to the design

    1.6 Center Resources From SPAN

    Note

    Add links to SPAN activity pages that are appropriate for this activity. Use links from the Activity section of the front page. SPAN

    Several Centers Process Asset Libraries have materials related to this activity. Related Processes, templates, and other resources may be found in the following Activities in SPAN (available to NASA only). 


    Div
    idtabs-2

    2. Defining the Activity

    Note

    This tab contains the links to pages in the SWEHB that are at the heart of the activity. 

    2.1 SWEs

    Note

    This section contains the links to SWE pages that form the heart of the activity. 

    • Copy of SWE-058 - Detailed Design with new tab 4
      • Excerpt Include
        Copy of SWE-058 - Detailed Design with new tab 4
        Copy of SWE-058 - Detailed Design with new tab 4
        nopaneltrue
      Link to the SWE goes here
      • Excerpt include for the SWE goes here (Remove Surrounding Panel)

    2.2 Topics and other Supporting Materials

    Note

    This section is for SWEHB pages, other than SWEs, that directly support the activity. This section contains Topics, document content pages, PATs, and other pages. 

    2.3 Other Associated SWEs, Topics, etc.

    Note

    Includes other SWEHB pages that are indirectly associated with the activity. May include SWEs, Topics, document definition pages, PATs, etc. They may have been mentioned in the guidance of another page. 

    • Include page for the PAT page goes here


    Div
    idtabs-3

    3. Software Assurance

    Software Assurance is integral to the performance of all Software Development activities. It includes Process Monitoring as well as Process Analysis. 

    • Process Monitoring - addresses the question, "Is the development team following their processes and producing the expected work products?"
    • Process Analysis - addresses the question, "Are there better ways of performing the processes that would result in the early discovery of defects?"

    3.1 Software Assurance Tasks

    Software Assurance Tasks are included in many of the SWEs in this activity. 

    Note

    For each of the SWEs in this activity (see tab 2 .1 SWEs) populate the table below with the SWE, Requirement, and SA Tasks.

    • The first column is for the SWE number
    • The second column is for the requirement - using the Excerpt Include macro to pull in the Excerpt from the SWE page (excerpt includes the text of the requirement)
    • The third column is for the SA Tasks using the Include Page macro - Each of the SA Tasks for a SWE are child pages under SITE:NASA-STD-8739.8B page 

    SWE-034 is used below only as an example of how to populate the table. The example below, using SWE-034, should be replaced by the actual SWEs in this activity. 

    SWERequirementSA Tasks

    034

    Excerpt Include
    SWEHBVD:SWE-034 - Acceptance Criteria
    SWEHBVD:SWE-034 - Acceptance Criteria
    nopaneltrue

    Include Page
    SWE-034 - SA Task1
    SWE-034 - SA Task1