Blogs in SWEHB were added in February, 2023. They started out as a way to introduce major changes in SWEHB to the user community.

SWEHBDOC Blogs In SWEHB

Web Resources

View this section on the website

See edit history of this section

Post feedback on this section

Section Labels:

Unknown macro: {page-info}

1. Introduction
2. Create a Blog Post
3. Blog Area
4. Blog History for SWEHBVD

1. Introduction to Blogs in SWEHBVD

Initially, blog postings are displayed in the Book A. Introduction page by creating a column on the right for listing the five most recently changed posts that have "swehb" as a label.

1.1 "Blog Posts" Macro

The "Blog Posts" macro displays the blog posts history. The macro is located in tab 1, in the right column, of the Book A. Introduction page. The macro and the parameters in this page as well as the New in SWEHB page are included below:

What's New in SWEHB!

Added Objective Evidence for Each Requirement

Objective evidence plays a crucial role in ensuring accountability, traceability, and reliability across software assurance and safety activities. It provides documented, unbiased proof that a specific activity has been performed or confirmed by the responsible software assurance/safety personnel — and it’s not just about checking a box. It amplifies the credibility of your processes.

Documenting objective evidence can take multiple forms depending on the activity being verified. Some examples include:

Audit Records and Checklist Results: Observations, findings, or risks identified, documented in a tracking system, or captured in emails.
Meeting Records: Attendance lists, meeting minutes, or notes stored in the project repository.
Status Updates: Memos, emails, or reports confirming an activity took place, supported by summaries or confirmation checklists.
Reviewed/Witnessed Activities: Signatures on reviewed products or processes to validate completion or compliance.
Short Summaries: Concise statements that provide insight into specific activities or milestones, such as:
- Progress on IV&V Program Execution.
- Percentage of hazards traced to software requirements.

When implemented consistently, objective evidence strengthens your project’s integrity, enhances collaboration, and aligns with the guidelines set forth in Section 8.16 of the handbook. Not only does it enable teams to track progress effectively, but it also instills confidence in the accuracy of assurance efforts.

The bottom line? Every requirement deserves solid, verifiable evidence. By prioritizing documentation, you’re not just managing activities — you’re building trust across the project.

swehb

Updated Topic 5.09 - SRS - Software Requirements Specification and PAT-059

5.09 - SRS - Software Requirements Specification guidance was rewritten with assistance from AI and PAT-059 updated.

Guidance for the Minimum Recommended Content of the Software Requirements Specification was rewritten and expanded using AI content. This rewrite includes expanded guidance, examples, and new guidance for Software Assurance. PAT-059 - Software Requirements Specification Assessment was updated to coincide with this new guidance.

swehb

Updated Topic 5.10 - STP - Software Test Plan

5.10 - STP - Software Test Plan guidance has been totally rewritten using AI.

Guidance for the Minimum Recommended Content of the Software Test Plan was rewritten and expanded using AI content. Due to the breadth of information and examples added, this enhanced guidance has been spread across multiple tabs.

swehb

New Topic 7.23 - Software Fault Prevention and Tolerance

Topic 7.23 has been added and is now available for use.

Topic 7.23 - Software Fault Prevention and Tolerance This topic guides developers to reduce the likelihood of software faults pre-flight and to detect/mitigate the effects of software errors should they occur in-flight.

swehb

New Topic on PLD Development and Software Assurance

A new Topic 8.30 - Flight and Ground PLD Development is now available.

PLDs, especially FPGAs, are becoming increasingly critical in complex avionics and space systems. Establishing a standardized and scalable approach to their development and assurance will not only improve consistency across NASA projects but also enhance mission safety and reliability. By emphasizing early planning, hazard management, training, cross-center collaboration, and consistent application of best practices, NASA can address current limitations while building a foundation for future advancements.

swehb

The macro uses the following parameters:

content type to display = excerpts - this gives a small amount of information with the rest of the blog hidden in an Expand macro.
restrict to these labels = swehb - this allows for building new posts for review without immediately posting them.
Restrict to these spaces = SWEHBVD - this keeps the posts local and not from other spaces
Maximum blog posts =
- 5 - limits the number of posts shown in the Introduction page.
- 100 - displays all posts (up to 100) in the "New in SWEHB" history page.
Sort by = Modified , check the Reverse box - this displays the posts based on the modified date and in reverse order, most recent displayed first.

2. Creating A Blog Entry

Creating a blog post is simple. On any page in SWEHBVD, hover over the blue circle icon with the plus sign at the top right header area of the page. You will be given two options, select "Create Content". A sub-menu will open for you to select the type of content to create. Select "Blog Post", then click "Create".

You will be required to put in a title for the post. Then you can start entering the text of the post. The entire body of the post should be inside of an "Excerpt" macro. Put in a sentence or two to explain the new feature in SWEHBVD that you are telling everyone about. If the announcement is longer than two sentences, you can put the rest of the text into an "Expand" macro within the Excerpt macro. Use the example below:

2.1 Code using Excerpt and Expand Macros

2.2 Finished Product

Example of the body of a Blog post using Excerpt and Expand macros

The SWEHB has a new look. A Blog will be used to advise you of major changes in SWEHB.

INTRODUCTION page has a listing of the latest 5 blog posts.
The link "New in SWEHB" will appear above the tabs on main SWEHB pages. it will open a page with the full Blog history.

More changes will be published as they are implemented.

"New in SWEHB" is a list of the full blog history, ordered from most recent to oldest.

To view the full blog history, click on the "New in SWEHB" link on any major page.

An Expand macro is used in the Excerpt macro to make the full text of the blog entry visible to the user without their having to open the post in another tab or window.

When you are done, save the post. It will be available for review in the blog area of SWEHBVD.

When you are ready to publish it to all users of SWEHBVD, add a label to the post. The label should be "swehb". all posts with this label are viewable in the New in SWEHB page as well as on the Book A. Introduction page in SWEHBVD.

You can check to see that it is available by going to the Introduction page finding it in the Blog list. Note, if you want it to be at the top of the list, you should make sure that it has been recently edited and saved.

3. Blog History Area of SWEHBVD

Each space in Confluence has a blog area where all blogs are stored. Blog pages are not stored in the same area as other pages in the space.

The Blog Area is where we can see posts that are "under construction" as well as those that are published (using the "swehb" label).

If you click on the title of any blog post, you will be sent to the Blog Area of SWEHBVD, and the blog entry you clicked on will be displayed.

From here you can edit and update a post if necessary. You can also delete a post if you must.

In the example, notice that in the top area, on the left is "Blog" followed by a date code "2022 / October / 25" This represents the date on which this blog entry was first created.

If you look at the "page history" you will find all the dates when changes were made.

On the right side, you will find a listing of months and years. This list can be expanded and contracted using the "+" and "-" icons in front of the date codes. When a month is expanded, it will show all of the blog entries created in that month. If a user gets into this display, they may be quickly confused by the dates on the blog entries. The Full History page ("New in SWEHB" link) is where users should be looking for history, not in this Blog Area.

4. "New In SWEHB" Page

The New in SWEHB page, is where all the SWEHBVD posts are displayed. A link to this page is being added to all of the major pages in SWEHBVD.

It differs from the Blog Area in that it is limited to only the posts displayed for general use by using the "swehb" label on the post. If a post does not carry the "swehb" label, it is not displayed in the New in SWEHB page or on the SWEHBVD Book A. Introduction page.

The macro used for this page is the "Blog Post" macro. The macro uses the following parameters:

content type to display = excerpts - this gives a small amount of information with the rest of the blog hidden in an Expand macro
restrict to these labels = swehb - this allows for building new posts for review without immediately posting them.
Restrict to these spaces = SWEHBVD - this keeps the posts local and not from other spaces
Maximum blog posts =100 - displays all posts (up to 100) in the New in SWEHB history page
Sort by = Modified , check the Reverse box - this displays the posts based on the modified date and in reverse order, most recent displayed first

Content

Space Tools