Page History

...

One approach to this might be to combine the Development and Assurance elements into a single activity to reinforce the notion that the two groups are expected to work in a coordinated way even though not in a closely coupled way. To show this, look at the Activity - Software Design page. This page shows the combination of Development Tasks and Assurance Tasks in a single activity. 

The activity "Software Design" was selected because it has only one SWE associated with it. Only one SWE is needed to show how it develops in the sections of the activity. It is more straight forward that trying to develop an activity like "Life Cycle  Planning" which has many SWEs. 

The content for each tab is listed here. in order to avoid duplicating a lot of text, the existing SWEs and Topics are referenced and linked as much as possible. A minimal amount of text is copied into the Activity page. In many cases, excerpts are used to bring text in. This will minimize the original authoring of a lot of text. 

...

• 2.1 SWEs - in NPR 7150.2D many of the SWEs are grouped together in activities. These groupings are preserved here and in some cases expanded upon. Planning, Peer Reviews, and Software Design are some examples of activities right from the NPR. In this section, each SWE is listed including: 
  • The title of the SWE (as a link to the SWE page)
  • Below the SWE title is a list of the tasks. Tasks are derived from the guidance on the SWE page. In some cases, this is simple because the tasks come from the subheadings in the guidance. In other cases, they may need to be derived from a review of the guidance text. 
•  2.2 Topics and Other Supporting Materials - these are other pages in the SWEHB that contain material relevant to the activity.
  • The title of the page is presented as a link to the page
    • Some are obvious by their titles, like, 7.7 - Software Architecture Description.  Others are less obvious.
    • Some may even apply to multiple activities. For example, a checklist for building a work product for an activity may also be used in performing a peer review of that work product. 
    • Some are links to document structures (most of these are collected under in topic 7.18)
    • Some are Process Asset Templates (PATs) - these are prototype assets built from the SWE guidance and intended to serve as a starting point for projects to use. Projects are encouraged to improve upon the content of the template to help their project. 
  • Below the title link is the page excerpt. Most pages have an excerpt which describes in a sentence or two what the page is all about. 
•  2.3 Other Associated SWEs, Topics, etc. - this is a catchall for other pages which are indirectly associated with the activity. In some SWEHB pages other SWEs are referenced and may be helpful to be included here. 

6.5.3 Tab 3 Software Assurance Activity

This tab brings out the relationship between Software Development and Software Assurance for the activity. Where tab 3 in the SWE provides guidance for Software Developers on how to satisfy the requirement, tab 7 provides guidance for Software Assurance on how to satisfy the requirement.

•  3.1 Software Assurance Tasks from SWEs - Tasking in tab 7 of the SWEs comes directly from NASA-STD-8739.8B. It is reproduced in this section of the tab for each SWE. 
  • The title of the SWE is listed as a link to the page. 
    • Tasking from tab 7 (NASA-STD-8739.8B) is listed. 
    • Software Assurance Products are listed
    • Metrics are listed
•  3.2 Topics and Other Supporting Materials - other SWEHB pages that describe Software Assurance activities. 
  • The title of the topic page is given as a link
    • The excerpt from the topic page is displayed
  • For PATs, the title of the PAT is given as a link to the page
    • The excerpt from the page is displayed. For a PAT, this is n image of the first page of the PAT. The image is linked to the PAT template document. 
  • There are some applicable topic pages that differ in their content. These are associated with topic 8.16. They contain content very similar to an activity in that it brings together tasks from multiple SWEs.
    • The title of the page is given as a link
      • The excerpt from the page is displayed
      • Related SWEs are listed along with tasking

•  3.3 Other Associated SWEs, Topics, etc. - this is a catchall for other pages which are indirectly associated with the activity. In some SWEHB pages other SWEs are referenced and may be helpful to be included here. It may be added if needed. 

6.6 Special Topics Pages That Seem To Mimic Activities

In building the third Activity example, Activity - Software Design, It became apparent that there are some new pages in the SWEHB tat are different from the typical SWE or Topic. In the latter days of SWEHBVC some work was done on a small number of pages in the 7.18 - Documentation Guidance. They were moved into Topic 8.16 - SA Products. As these pages developed further, they became more than just a "minimum content" description. They blossomed into very detailed guidance pages, looking somewhat like activity descriptions. 

These pages have sections for: 

• Listings of SA tasking from multiple SWEs
• Guidance for performing the tasks. Including:
  • checklists and PATs for the tasks
  • descriptions of interfaces with other entities such as SARB
  • descriptions of various reviews 
  • techniques
  • recommended content for various types of reports 
• Guidance for performing Safety Analysis, Hazard Analysis, etc.
• Analysis Reporting Content
• Safety related content
• Tasks needing Objective Evidence

Certainly, all of these pages and content are valuable as topics for providing guidance on performing all types of work related activities. It may be somewhat of a challenge to accurately represent all of this content in the Activity format. Part of the concern is that it is currently under development and changes to the content will require that the Activities which point to them will need maintenance to keep up with the development in these areas. We will have to look carefully at these topics and come up with a way to include their content in Activities without getting too exhaustive in the Activity. Case in point,

• In my attempt to be inclusive in my Activity - Software Design page, I may have too much detail in section 3.2 where I go down to the task level on the Software Design Analysis page. 
• Conversely, there may not be enough detail in the activity to cover other tabs in the Software Design Analysis page such as:
  •  Safety Analysis During Design 
  • Analysis Reporting Content