This version of SWEHB is associated with NPR 7150.2B. Click for the latest version of the SWEHB based on NPR7150.2C
188.8.131.52 The designated Engineering Technical Authority(s) shall define the content requirements for software documents or records.
The recommended practices and guidelines for the content of different types of software activities (whether stand-alone or condensed into one or more project level or software documents or electronic files) are defined in NASA-HDBK-2203. The Center defined content should address prescribed content, format, maintenance instructions, and submittal requirements for all software related records. The designated Engineering Technical Authority for software approves the required software content for projects within their scope of authority. Electronic submission of data deliverables is preferred.
Software development requiresdocumentation and implementation. Software development activities require decisions and work results (e.g., requirements, design, outcome of reviews, etc.) to be captured as building blocks throughout the software life cycle. Software developers and software acquisitions need to know what documentation expectations exist for a development project. Having defined and approved content descriptions for project documentation allows these needs and more to be met.
Typically, software documentation content is defined in a Center data requirements management system, or equivalent. The Engineering Office of Primary Responsibility (OPR) is responsible for approving any proposed tailoring of that defined content. If the content required for the software documentation is the same as the defined content in the Center data requirements, then the ETA job is easy.
The ETA on a project coordinates with the Engineering Office of Primary Responsibility (OPR) and the software engineering organizations to ensure modifications to the documentation content are acceptable. The policy for Center-wide data management is provided in NPR 7123.1 486, Systems Engineering Processes and data management implementation guidance to program/projects is documented in Center Data Management Guidance.
Topic 7.18 – Documentation Guidance in this Handbook provides a minimum set of contents for software project documentation at the Agency level. The designated ETAs at each Center can choose to use this minimum content “as is” or use it to define a set of Center documentation descriptions which are specific to the software projects at that Center.
Center-specific, ETA-approved documentation descriptions for software-related records include the following basic elements:
- Specific content – list and description of expected content; topics with descriptions of material and information to be addressed and included in the document.
- Content format – format of specified content within the document itself; structure of the document; document layout.
- Maintenance instructions – guidelines for when (frequency, criteria) and how the document is to be updated, revised, kept current with project progress and activities; may include recommendations regarding who is to perform the maintenance activities.
- Submittal requirements – guidance for delivery of document to NASA (for contracted software development efforts) or project personnel such as management and peers, including delivery frequency, format (electronic is preferred), instructions for placement into electronic repositories, etc.
Electronic submission of data deliverables is preferred, so the defined content, format, maintenance, and submittal requirements defined by the ETA are to encourage electronic delivery.
Documentation content can be specified as a set of templates, data item descriptions (DIDs), database forms, or any other format that can be accessed and used by Center projects as well as added to subcontractor software development agreements by acquisition personnel.
The approved documentation guidance is kept in a Center-level repository for ease of access by Center projects and acquisition personnel. Center-specific guidance and resources, such as templates, are typically available in Center Process Asset Libraries (PALs).
Center documentation guidance may also be submitted for addition to the Software Processes Across NASA (SPAN) repository. NASA-specific documentation templates, examples, checklists, and more are available in SPAN, accessible to NASA users from the SPAN tab in this Handbook.
4. Small Projects
No additional guidance is available for small projects.
Tools relative to this SWE may be found in the table below. You may wish to reference the Tools Table in this handbook for an evolving list of these and other tools in use at NASA. Note that this table should not be considered all-inclusive, nor is it an endorsement of any particular tool. Check with your Center to see what tools are available to facilitate compliance with this requirement.
No tools have been currently identified for this SWE. If you wish to suggest a tool, please leave a comment below.
6. Lessons Learned
No Lessons Learned have currently been identified for this requirement.